E-File Magic

Deliverables

Get a deliverable

Read the available files and instructions for one order's deliverable.

POST
/api/v1/orders/deliverables/get
Authentication
OAuth 2.0 access token
Required scopes
deliverables.read
Idempotency key
Not required
Rate-limit cost
1 unit

How to use this endpoint

The default service is irs_spec_file. State groups include filing instructions and official links when available. Request a file separately when you are ready to download it.

reviewed_at is a calendar date. Display it in the viewer’s regional format without shifting the day for their time zone. Update and expiry timestamps represent instants and should use the viewer’s time zone.

For efile and tin_matching results, materialization_status and each format status govern file availability. Final IRS outcomes may precede ready downloads. Excel is the xlsx wire format. Refresh metadata while preparation is pending; do not infer download readiness from accepted counts or request a new filing to obtain result files.

cURL request
curl --request POST 'https://api.efilemagic.com/api/v1/orders/deliverables/get' \
  --header 'Authorization: Bearer <access-token>' \
  --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.