E-File Magic

Orders

Get multiple orders

Read the current status of several orders.

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

How to use this endpoint

Results keep the request order and report missing IDs separately. Use deliverable endpoints for downloadable files.

Invoice PDFs show the recorded card/ACH payment ending or approved A/R terms. Totals end Total, Paid, Balance Due; authorization alone is not payment. New invoice copies reflect confirmed payments. Historical originals remain unchanged; unavailable legacy payment-ending evidence does not prevent an invoice download.

The efile service is displayed as Combined Federal/State e-File (CF/SF). E-File Magic participates in the IRS CF/SF program for eligible filings. The API service_code remains efile; this display name does not change pricing or filing eligibility.

Customers can add Print & Mail or State Reporting File to an eligible existing order through Add services in the signed-in Dashboard or Order Tracking checkout. This is an interactive customer payment flow, not an External API mutation. Subsequent reads include the added services and updated totals on the same order; invoice payment labels reflect multiple payments without attributing the total to the original card.

Request example

cURL request
curl --request POST 'https://api.efilemagic.com/api/v1/orders/get_many' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --data '{"order_ids":["11111111-1111-4111-8111-111111111111"]}'

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