PrintJob.Read | Graph Permissions

Permission Details

Delegated Permission

Read user's print jobs

Allows the application to read the metadata and document content of print jobs that the signed-in user created.

Permission ID: 248f5528-65c0-4c88-8326-876c7236df5e

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`configuration`	`printJobConfiguration`	A group of settings that a printer should use to print a job.
`createdBy`	`userIdentity`	Read-only. Nullable.
`createdDateTime`	`DateTimeOffset`	The DateTimeOffset when the job was created. Read-only.
`id`	`String`	The ID of the print job. Read-only.
`isFetchable`	`Edm.Boolean`	If true, document can be fetched by printer.
`redirectedFrom`	`Edm.String`Nullable	Contains the source job URL, if the job has been redirected from another printer.
`redirectedTo`	`Edm.String`Nullable	Contains the destination job URL, if the job has been redirected to another printer.
`status`	`printJobStatus`	The status of the print job. Read-only.
`errorCode`	`Int32`Nullable	The error code of the print job. Read-only.
`acknowledgedDateTime`	`DateTimeOffset`Nullable	The dateTimeOffset when the job was acknowledged. Read-only.
`documents`	`printDocument collection`
`tasks`	`printTask collection`	A list of printTasks that were triggered by this print job.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "@odata.type": "#microsoft.graph.printJob",
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "status": {
    "@odata.type": "microsoft.graph.printJobStatus"
  },
  "createdBy": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "configuration": {
    "@odata.type": "microsoft.graph.printJobConfiguration"
  },
  "redirectedTo": "String",
  "redirectedFrom": "String",
  "isFetchable": "Boolean"
}

Relationships

Microsoft Graph v1.0 exact-category-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`documents`	`printDocument collection`	Read-only.
`tasks`	`printTask collection`	A list of printTasks that were triggered by this print job.
`configuration`	`printJobConfiguration`	Related configuration data exposed by this resource.
`status`	`printJobStatus`	Related status data exposed by this resource.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/print/printers/{id}/jobs/{id}`
GET `/print/printers/{printerId}/jobs`
GET `/print/printers/{printerId}/jobs/{printJobId}/documents/{printDocumentId}/$value`
GET `/print/services`
GET `/print/services/{printServiceId}`
GET `/print/services/{printServiceId}/endpoints`
GET `/print/services/{printServiceId}/endpoints/{printServiceEndpointId}`
GET `/print/shares/{id}/jobs/{id}`
GET `/print/shares/{printerShareId}/jobs`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/print/printers/{id}/jobs`
GET `/print/printers/{id}/jobs/{id}`
GET `/print/printers/{id}/jobs/{id}/documents/{id}/$value`
GET `/print/services`
GET `/print/services/{id}`
GET `/print/services/{id}/endpoints`
GET `/print/services/{id}/endpoints/{name}`
GET `/print/shares/{id}/jobs`
GET `/print/shares/{id}/jobs/{id}`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgPrintPrinterJob` /print/printers/{id}/jobs/{id} Get printJob
`Get-MgPrintPrinterJob` /print/printers/{printerId}/jobs List printJobs for a printer
`Get-MgPrintPrinterJobDocumentContent` /print/printers/{printerId}/jobs/{printJobId}/documents/{printDocumentId}/$value Download printDocument binary file
`Get-MgPrintService` /print/services List printServices
`Get-MgPrintService` /print/services/{printServiceId} Get printService
`Get-MgPrintServiceEndpoint` /print/services/{printServiceId}/endpoints List endpoints
`Get-MgPrintServiceEndpoint` /print/services/{printServiceId}/endpoints/{printServiceEndpointId} Get printServiceEndpoint
`Get-MgPrintShareJob` /print/shares/{printerShareId}/jobs List printJobs for a printerShare

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgBetaPrintPrinterJob` /print/printers/{id}/jobs List printJobs for a printer
`Get-MgBetaPrintPrinterJob` /print/printers/{id}/jobs/{id} Get printJob
`Get-MgBetaPrintPrinterJobDocumentContent` /print/printers/{id}/jobs/{id}/documents/{id}/$value Download printDocument binary file
`Get-MgBetaPrintService` /print/services List printServices
`Get-MgBetaPrintService` /print/services/{id} Get printService
`Get-MgBetaPrintServiceEndpoint` /print/services/{id}/endpoints List printServiceEndpoints
`Get-MgBetaPrintServiceEndpoint` /print/services/{id}/endpoints/{name} Get printServiceEndpoint
`Get-MgBetaPrintShareJob` /print/shares/{id}/jobs List printJobs for a printerShare

Code Examples

C# / .NET SDK

Download printDocument binary file

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Print.Printers["{printer-id}"].Jobs["{printJob-id}"].Documents["{printDocument-id}"].Content.GetAsync();

JavaScript

Download printDocument binary file

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let stream = await client.api('/print/printers/{printerId}/jobs/{printJobId}/documents/{printDocumentId}/$value')
	.get();

PowerShell

Download printDocument binary file

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Devices.CloudPrint

Get-MgPrintPrinterJobDocumentContent -PrinterId $printerId -PrintJobId $printJobId -PrintDocumentId $printDocumentId -OutFile $outFileId

Python

Download printDocument binary file

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.print.printers.by_printer_id('printer-id').jobs.by_print_job_id('printJob-id').documents.by_print_document_id('printDocument-id').content.get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for PrintJob.Read

4

Grant Admin Consent

Users can consent to this permission during sign-in.