E-File Magic

PDFs

Preview recipient PDFs

Generate recipient forms using the selected annual template.

POST
/api/v1/recipients/print
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 and both documents.read and tax_ids.read. Immediate results contain url; scheduled results contain export_id; pass that value in job_ids when polling. No email is sent. Missing templates return an error. After an uncertain result, keep the original idempotency key; do not automatically create another print request with a fresh key.

This endpoint prints current saved recipient data. Historical order-snapshot PDFs are available through the authenticated application’s Recipient History → View released PDF action; this public API endpoint does not accept an order_id selector.

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/recipients/print' \
  --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.