E-File Magic

Saved filing reviews

Prepare a saved filing review

Prepare a fixed selection for the authorizing user to review.

POST
/api/v1/filing-reviews/prepare
Authentication
OAuth 2.0 access token
Required scopes
orders.previewrecipients.readforms.readfilers.read
Idempotency key
Required
Rate-limit cost
15 units

How to use this endpoint

This REST workflow requires delegated agent authorization and 1–10 distinct original recipients with their current versions and exact annual form contract. It returns a review link and expiration without approving, charging or submitting. For the MCP checkout workflow, use orders/checkout/request instead; its filer/year workflow has no form-count ceiling.

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/filing-reviews/prepare' \
  --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.