E-File Magic

PDFs

Generate filer PDFs

Generate or schedule PDFs for a filer using the requested filters.

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

How to use this endpoint

This operation requires a delegated user, documents.read and tax_ids.read. Up to 100 forms are generated immediately; larger selections are scheduled. Immediate responses contain download_url; scheduled responses contain export_id. Pass that value in job_ids to print_jobs/get_many when polling for completion. No PDF-ready email is sent. Do not split requests to bypass scheduling or retry an uncertain result with a new key.

Retrying a request? Keep the same idempotency key and body after an uncertain result. A different key can repeat the action.

cURL request
curl --request POST 'https://api.efilemagic.com/api/v1/pdfs/print_jobs/schedule' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Idempotency-Key: <unique-operation-key>' \
  --header 'Content-Type: application/json' \
  --data-binary @request.json

Replace placeholders with your own values. Use the API resource origin provided for your environment.

Create request.json using the documented fields. Field descriptions are not sample values.