E-File Magic

Orders

Submit an order

Purchase the selected services and submit an order for processing.

POST
/api/v1/orders/submit
Authentication
OAuth 2.0 access token
Required scopes
orders.submit
Idempotency key
Required
Rate-limit cost
100 units

How to use this endpoint

Review a fresh preview, terms and funding before calling this endpoint. Explicit terms_accepted=true, the current terms_version and order_signature_crypto remain required when customer deposits cover the full total. After an uncertain 500 or 503, retry the exact body with the same Idempotency-Key. Do not start a replacement order while the outcome is uncertain. Review a 409 or 412 and obtain a fresh preview before submitting again.

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.

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/orders/submit' \
  --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.