Developer workspace IRIS sandbox
Sandbox
IRIS developer sandbox

Submit. Approve. Track.

Test free across the IRIS form catalog with synthetic data. Sandbox keys expire after 24 hours. The IRS expects TY2026 production to open in January 2027. See TaxFileAPI launch status ↗

2. Approve and track

Open the hosted review to approve the exact batch using test credits. Then check its status here. For the delayed fixture, the simulated acknowledgment appears after six seconds.

Manage test credits ↗

Submit a batch to see its response.

Try one cURL call

Set TAXFILEAPI_SANDBOX_KEY to your sandbox key. This example uses a sandbox-only approval header to return an immediate acknowledgment for the accepted fixture.


Complete API reference ↗ · OpenAPI JSON ↗

Optional signed webhook

Use polling or a configured HTTPS webhook. Sandbox destinations are provisioned by the operator. If enabled, key creation returns a signing secret. Verify the HMAC-SHA256 of the timestamp, a period, and the exact body using the TaxFileAPI-Signature header. Deduplicate by event ID.

Sandbox delivery attempts on approval and on status checks until one succeeds. Keep GET available for reconciliation.

Set up a provider account ↗