How the API will work.
Every call follows the same rules, prices and statuses as the app.
- 01Sandbox on every plan
Build and test against a sandbox that never calls the IRS. A TIN's last digit sets the IRS code, so you can test every result.
- 02Live on Professional and Enterprise
Live keys work for companies on Professional or Enterprise. Each call is charged from that company's wallet at its plan's rate.
- 03Keys and roles
Owners and Admins make, rotate and revoke keys in the API Hub, with two-factor sign-in.
- 04Webhooks
We send an event when the IRS answers a TIN check or accepts a return, so you never poll.
- 05Safe to retry
Every call that creates something takes an idempotency key, so a retry never files or charges twice.
- 06Clear errors
Every error has a stable code, a plain message and the one next step.
One API for TIN checks and 1099s.
| Do this | Through the API |
|---|---|
| Check a name and TIN | One real-time check, or a bulk check of up to 10,000 with results by webhook |
| File 1099s | Add payers and recipients, create returns, submit them through IRIS |
| Correct and void | Correct or void an accepted return; we choose the IRIS correction type |
| Recipient copies | Mail copies at cost or download them |
| Money | Read your wallet balance, rate card and every charge |