E-file 1099 information returns via the IRS IRIS API

domain: iris.irs.gov · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Apply for IRIS access on the IRS portal; for Application-to-Application (A2A) filing you will need a Client ID and must upload a JSON Web Key Set (JWKS) to the IRS application, which issues credentials after validation.
  2. Authenticate using the OAuth 2.0 client credentials flow specific to IRIS to obtain an access token; the token is used as the credential on all subsequent IRIS API calls.
  3. Build each 1099 record as a valid XML document conforming to the IRIS schema specified in IRS Publication 5718 (Processing Year 2026 edition); the API accepts XML-formatted payloads.
  4. POST the XML payload to the IRIS submission endpoint; the API returns a submission ID that you use to track processing status.
  5. Poll the status endpoint with the submission ID until the response indicates accepted or rejected; for rejected submissions, parse the error codes and correct the underlying records before resubmitting.
  6. Observe form-specific filing deadlines: 1099-NEC must be filed by the last day of January; most other 1099 forms are due by 31 March when filed electronically — IRIS replaced FIRE as the primary intake system for information returns for filing season 2027.

Known gotchas

Related routes

File a batch of 1099-NEC information returns via the IRS IRIS A2A SOAP API
iris.irs.gov · 6 steps · unrated
Poll the IRS IRIS A2A SOAP API for transmission status and retrieve XML acknowledgments for previously submitted 1099 information returns
irs.gov · 6 steps · unrated
E-file 1099-NEC forms via a third-party tax filing API
irs.gov/e-file-providers · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans