E-File Magic

Orders

Preview an order

Check eligible recipients, services and current pricing before submitting an order.

POST
/api/v1/orders/preview
Authentication
OAuth 2.0 access token
Required scopes
orders.preview
Idempotency key
Not required
Rate-limit cost
10 units

How to use this endpoint

A preview does not charge or submit. Review the total, funding and policy version, then pass the expected values to submit. The tax year must match the filer. State E-File is unavailable; State Reporting File and federal CF/SF remain separate services. pricing_basis describes the account's per-order or cumulative-year pricing. Cumulative pricing is the default unless staff explicitly disables it; cancelled orders do not contribute annual volume. Clients cannot set the accumulated volume.

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.

cURL request
curl --request POST 'https://api.efilemagic.com/api/v1/orders/preview' \
  --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.