Find your form
Each form has its own IRIS page with four things: the business rules that apply to that form, a picture of the form with the IRIS element at every box, every element of its XML record, and the Taxpayer Portal CSV template columns. Pick a form to go straight there.
All of them on one page, with rule and element counts: IRIS rules, field maps and CSV templates for every form.
What IRIS is, and the two ways in
IRIS, the Information Returns Intake System, is how the IRS takes 1099s, 1098s, 5498s, W-2Gs, 1042-S and the other information returns electronically. It replaces FIRE, which closes to filings on Nov. 19, 2026; from Jan. 1, 2027 IRIS is the only electronic system for originals, prior years and corrections. There are two ways in:
- The IRIS Taxpayer Portal, free on IRS.gov, where you key forms in or upload the IRS CSV templates. It suits filers with a few hundred returns or fewer.
- Application to Application (A2A), where software sends XML transmissions built to the IRIS schema. It suits software providers, service bureaus and large filers.
Either way you need an IRIS Transmitter Control Code from the IRIS Application for TCC. A FIRE TCC does not carry over. How to apply, screen by screen.
Getting set up
Start with the TCC, then pick the route. Each page below covers one step.
How a return moves through IRIS
The same four stages apply to the portal and to A2A. Each box opens the page or tool for that stage; the tools and error codes are in the next two sections.
Click any box for the page behind it. A FIRE TCC does not carry over; the FIRE to IRIS guide covers the application and dates.
Tools and references
Error codes and rules
Mapping: boxes, XML elements and FIRE positions
Check a file before you send it
The error codes filers hit most
Every IRIS acknowledgment names the business rules a return broke, by rule number, for every filer: Taxpayer Portal or software. The IRS named four as its “Top Business Rules” at the IRIS Working Group meeting of January 14, 2026 (IRS slides). Two of the four are a recipient name that does not match its TIN:
- S1H002 Report error If the Combined Federal/State Filing election is made, the TCC must be in the CF/SF program.
- SHAREDIRFORM015 Report error Recipient business name and TIN do not match IRS records
- S1H001 Report error The issuer's phone number is required.
- SHAREDIRFORM014 Report error Recipient name and SSN do not match IRS records
Other name and TIN rules
These check the issuer's name against its TIN, and a recipient TIN that is missing or repeated:
- SMF017 Reject Issuer name and TIN (individual) do not match IRS records
- SMF018 Reject Issuer business name and EIN do not match IRS records
- SHAREDIRFORM023 Report error Recipient TIN is missing
- FS1H001 Report error Same recipient TIN twice without unique account numbers
A submission with too many errors is rejected as a whole under ThresholdRule. For every other code: all 14 cross-form error code pages, each form's own rules, or search them all in the lookup.
See also: The IRIS TCC application, screen by screen.
Questions people ask
Is IRIS free?
Yes. The Taxpayer Portal is free; A2A needs software that has passed IRS testing, which may be free or paid depending on the provider.
Can I still use FIRE?
Only until its filing window closes on Nov. 19, 2026. After that, everything goes through IRIS, including corrections of returns first filed through FIRE.
Does IRIS have a test system?
For A2A, software developers test in the Assurance Testing System. The Taxpayer Portal has no test mode, so check a CSV before uploading it.
How do I correct a return filed through FIRE?
In IRIS, as a corrected record that names FIRE as the original system and gives the original TIN and name. See the corrections guide.