E-File Magic

PDFs

Get PDF jobs

Read PDF job status and obtain completed downloads.

POST
/api/v1/pdfs/print_jobs/get_many
Authentication
OAuth 2.0 access token
Required scopes
recipients.readforms.readdocuments.readtax_ids.read
Idempotency key
Not required
Rate-limit cost
5 units

On success, data contains the fields below. meta includes api_version and request_id. Keep request_id when reporting a problem.

Response fields

2 fields
itemsAlways returnedarray<object>

Type: array<object>.

Nested fields (9)

delivery_kindAlways returnedstring | null

Allowed values: "pdf", "zip", "manifest", null.

download_urlAlways returnedstring | null (uri)

Type: string | null (uri).

export_idAlways returnedstring (uuid)

Type: string (uuid).

filer_idAlways returnedstring (uuid)

Type: string (uuid).

form_idAlways returnedstring | null

Type: string | null.

job_idAlways returnedstring (uuid)

Type: string (uuid).

recipient_form_countAlways returnedinteger

Type: integer.

statusAlways returnedstring | null

Allowed values: "queued", "processing", "merging", "completed", "failed".

tax_yearAlways returnedinteger

Allowed values: 2022, 2023, 2024, 2025, 2026.

missingAlways returnedarray<string (uuid)>

Type: array<string (uuid)>.

Complete response schema: ApiV1PdfPrintJobsResponse

Structure · HTTP 200
{
  "data": {
    "items": "array<object>",
    "missing": "array<string (uuid)>"
  },
  "meta": {
    "api_version": "v1",
    "request_id": "string"
  }
}

Successful response structure. This outline shows field types, not a response to copy. Expand Response fields for nested properties and optional values.