TY2026 · Free testing now

The transmission API for IRS e-file.

Test your IRIS integration for free now. The IRS expects TY2026 production to open in January 2027. Eligible filings will use prepaid account credits once TaxFileAPI live filing is enabled.

Free sandbox · IRIS information returns

Transmission requestSandbox example
POST/v1/sandbox/transmissions
{
  "channel": "iris",
  "form": "1099-NEC",
  "scenario": "accepted"
}
202 Accepted · Sandbox receipt issued
01 Select a form02 Submit a test fixture03 Retrieve the acknowledgment

Transmission sandbox

Choose a form and an outcome. Run a synthetic transmission and inspect the receipt and acknowledgment.

Synthetic data only
Request JSON
{
  "channel": "iris",
  "form": "1099-NEC",
  "scenario": "accepted"
}
Acknowledgment
Run a transmission to see its response.

All receipts and acknowledgments here are simulated. This sandbox uses no IRS connection or payment.

Single-fixture simulator

Call the same sandbox endpoints from your integration. No developer key is required for single-fixture simulations. Requests accept a catalog form and a synthetic outcome.

Submit a transmission

Send JSON to receive a 202, a receipt ID, and an acknowledgment URL. Each request generates a fresh demo receipt.

Retrieve an acknowledgment

Make a GET request to the returned acknowledgment_url. Pending fixtures remain pending. Rejected fixtures include a synthetic finding.

GET /v1/sandbox/acknowledgments/{receipt_id}

Handle errors

Errors contain error.code and error.message. Expect 400 for invalid JSON, 404 for a malformed receipt, 413 above 1 KB, 415 for another media type, and 422 for an unsupported fixture.

Form families

Select an IRIS form to try it in the sandbox. For the batch API, see form and tax-year support in the API catalog.

IRIS A2A

Federal information returns and eligible extensions.

Information returns
Mortgage and education
Savings and benefits
Other information returns

Tax Returns

TY2026 sandbox preparation

Try preparing synthetic MeF drafts. Production filing requires verified ERO or Online Provider credentials.

Open Tax Returns sandbox ↗

IRS IRIS reference ↗ · IRIS form and schema catalog ↗

Prepaid filing credits

Testing is free. When live filing is enabled, buy a credit pack in one account checkout and apply credits to eligible IRIS batches.

Developer sandbox

$0

Run IRIS fixtures and test balance, approval and acknowledgments with simulated credits.

Account credits

One credit per eligible information return. Credit packs will be available when live filing opens.