How the API will work.
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 |