FIRE → IRIS Migration

How to Migrate From FIRE to IRIS (Step by Step)

FIRE is being retired, and the files you have produced for years will not upload to its replacement as they are. Here is the practical migration path — why your FIRE files won’t go straight into IRIS, what you actually have to convert, and how to file your first IRIS batch before the deadline catches you.

At a glance

Migrating from FIRE to IRIS is not a file upload — it is a re-platforming. You will need a new IRIS Transmitter Control Code (TCC), because the code you used on FIRE does not carry over, and the fixed-width FIRE files you already produce have to be re-shaped into the format IRIS actually reads. The IRS plans to retire FIRE after the tax year 2026 season, with the system shutting down following December 31, 2026. Because the TCC suitability review behind your approval runs a minimum of 45 business days and cannot be expedited, the migration is really a scheduling problem more than a technical one. If your deadline won’t wait, a provider that already holds an IRIS TCC can file your data today.

In this story

Why Your FIRE Files Won’t Just Upload to IRIS

The instinct is a reasonable one: you have a folder of FIRE-format files that the IRS accepted last year, so surely you can point them at the new system and be done. You cannot. IRIS is a different platform with a different identity model and a different file format, and there is no IRS tool that lifts a FIRE submission into IRIS unchanged.

Two separate things have to change before a single record reaches IRIS. The first is your identity on the system. Your FIRE TCC does not carry over, because the IRS treats FIRE and IRIS as separate systems with separate Transmitter Control Codes and no conversion path between them, so you begin with a fresh IRIS application rather than a migrated account. The second is the file itself, which has to be reshaped. FIRE expects a fixed-width flat file built to the legacy Publication 1220 record layout, where every value is identified by its character position on the line, while IRIS accepts data through its own channels and named formats. The bytes you already have simply do not line up with what IRIS reads.

Official source Pub 5717

The IRIS Taxpayer Portal is documented in the IRIS Taxpayer Portal User Guide (Publication 5717), while machine-to-machine (A2A) filing is covered in Publication 5718 and assurance testing in Publication 5719. The application that issues your TCC lives in IRS e-Services, and the FIRE retirement timeline is announced on the IRS FIRE system page.

The Deadline Behind the Migration

Migration feels like a someday project until you do the arithmetic. The IRS plans to retire the FIRE system after the tax year 2026 filing season, with FIRE accepting its last submissions and shutting down following December 31, 2026. That date is the outer wall, and it is the one most people fixate on. The constraint that actually governs your calendar, though, sits well in front of it.

To file on IRIS you must already hold an approved IRIS TCC, and the suitability review behind that approval takes a minimum of 45 business days — roughly nine working weeks — and cannot be expedited. Once you stack identity verification, the application itself, and any follow-up the IRS asks for on top of that review, a realistic runway stretches to somewhere between two and four months. The date that governs you is not the FIRE sunset; it is the day you must start your IRIS application in order to be approved before your first filing deadline.

The migration deadline that matters isn’t the day FIRE turns off — it’s the day you must start the IRIS TCC process to clear suitability before January 31. Count backward, not forward.— — e1099f compliance desk
Do the math backward

If you begin the TCC application in the fall, the 45-business-day review may not clear before the January 31 deadline for 1099-NEC, which is the tightest of the season. Treat any fourth-quarter start date as already late, and do not assume FIRE will still be sitting there as a fallback for the 2026 season once it has sunset.

The Migration Path: Four Stages, In Order

A clean migration breaks into four stages, and the order matters as much as the steps themselves. Most of the pain in a botched migration comes from skipping ahead: people convert their files before they hold a TCC, or they try to file before they have tested, and then the work has to be redone from the beginning. The table below lays out the sequence and who each stage applies to.

StageWhat it involvesWho it applies to
1. Get an IRIS TCCNew IR Application for TCC in e-Services, after ID.me verificationEveryone
2. Choose your channelPortal (manual entry or CSV) or A2A (XML over an API)Everyone
3. Convert your dataReshape FIRE flat files into CSV (Portal) or IRIS XML (A2A)Anyone reusing FIRE files
4. Test, then fileA2A filers pass IRS assurance testing (ATS) first, then transmit; Portal filers upload directlyEveryone, with an extra test gate for A2A

Step 1: Apply for a New IRIS TCC

This is the long-lead item, so it is the one you start first. The application is the Information Returns (IR) Application for TCC in IRS e-Services, and it is the same form regardless of which 1099-series forms you intend to file. The full depth of this step lives in our companion walkthrough on getting your IRIS TCC; what follows here is the shape of it, so you can schedule the migration realistically.

1

Verify identity with ID.me

Your Responsible Official and every authorized user completes ID.me identity proofing through e-Services. Nothing else in the process moves until this is finished.

~5–15 min per person
2

Submit the IR Application for TCC

Enter your organization’s legal name and EIN exactly as the IRS holds them, name your Responsible Officials, and choose your roles and transmission method.

~30–45 min
3

Wait out the suitability review

The IRS reviews tax compliance and identity for the organization and each official. Submit once and monitor e-Services, because resubmitting only restarts the clock.

Review: up to 45 business days
Not the same as your FIRE TCC

If you held a FIRE TCC, you cannot reuse it — IRIS requires a brand-new code with no shortcut from the old one. For the specifics of how the two differ and what to do with your old code, see how the IRIS TCC differs from your FIRE TCC.

Step 2: Choose Portal or A2A

IRIS gives you two ways in, and the one you choose decides how much conversion work stands between you and your first filing. The right call comes down to your volume and whether you have developers on hand, not to which system you happened to use before.

The Taxpayer Portal (TP) is the web route: you enter records by hand or upload a CSV built to the IRIS template. It needs no developers and no schema work, which makes it the natural landing spot for most filers leaving FIRE. A2A (Application-to-Application) is the machine-to-machine route, where your software sends IRIS XML directly over an API. A2A scales to very high volume, but it adds a schema build and mandatory assurance testing before you can go live. Many former FIRE bulk transmitters end up on A2A, while smaller filers are usually better served by the Portal’s CSV upload template.

Step 3: Convert Your FIRE Files

This is the stage people consistently underestimate. Your FIRE files are fixed-width records built to the legacy Publication 1220 layout, where every field is identified by its character position on the line. IRIS does not read by position at all. The Portal reads a CSV mapped to its own column template, and A2A reads named XML elements, so either way the same underlying data has to be lifted out of the flat file and re-expressed in the target shape.

The most visible difference is the recipient name. FIRE packs the entire payee name into a single position-based field, whereas IRIS expects discrete, named elements for the separate parts of a name. One flat-file field becomes several distinct XML elements, and the conversion has to split it correctly — this is exactly where most mapping errors hide:

FIRE — payee record (fixed-width)
pos 248–287 JOHN A SMITH pos 67–78 000000125000 pos 13–21 123456789
Pub 1220 layout
VS
IRIS — named XML elements
<PersonFirstNm>John</PersonFirstNm> <PersonLastNm>Smith</PersonLastNm> <Amt>1250.00</Amt> <TIN>123456789</TIN>
IRIS schema
Hover a line to see how a single FIRE field maps to its IRIS counterpart. Element names are illustrative — the authoritative schema is defined in Publication 5718.

These positions and element names are illustrative, shown for orientation only; the real record layout is defined by IRS Publication 5718 for A2A and by the IRIS Portal CSV templates for the web route. For the full field-by-field mapping, see our guide to converting FIRE flat files to IRIS XML.

Step 4: Test, Then File Your First Batch

With a TCC in hand and your data converted, you are ready to transmit — but A2A filers have one gate left to clear. Before any live transmissions, you build XML against the IRIS schema and pass Assurance Testing System (ATS) scenarios, which is how the IRS confirms your output is well-formed before it ever touches production. Portal filers skip ATS entirely; you simply log in and upload your CSV or key the records in by hand.

For your first real batch, file small. Submit a single form type for a handful of payees, confirm that you receive an acknowledgment back, and verify the status before you send the rest. IRIS returns a receipt for accepted transmissions and rejection detail for failures, so a small first run surfaces any mapping problem cheaply — on ten records rather than ten thousand. Once that small batch clears, you can scale up with confidence.

Re-platforming under deadline pressure?

e1099f already holds an IRIS TCC and converts the FIRE files you produce today — see how the managed path skips the new application, the conversion, and ATS.

See how it works

Common Rejection Reasons (and How to Avoid Them)

Migration introduces failure points the old FIRE-to-FIRE routine never had: a new credential, a new file shape, and a new test gate. These are the ones that bite migrating filers most often, and every one of them is avoidable if you see it coming.

Trying to file under the old FIRE TCC most common

Cause: assuming the FIRE TCC works on IRIS, or that your filing authorization carries over automatically. The two systems share no credentials whatsoever. Fix: apply for a new IRIS TCC through e-Services and budget the full 45-business-day review before your deadline.

Uploading a FIRE flat file unchanged

Cause: sending a fixed-width Pub 1220 file to IRIS, which reads CSV on the Portal or named XML over A2A, not character positions. Fix: convert the data to the target format first, splitting combined fields such as the payee name into the discrete elements IRIS expects.

EIN / legal-name mismatch on the application

Cause: the name on the TCC application does not match the name tied to the EIN in IRS records. Fix: use the exact legal name from your EIN assignment notice (CP 575), not a DBA or a shortened version.

Skipping ATS and failing in production

Cause: A2A filers transmitting live before passing assurance testing, then discovering schema errors on the real batch. Fix: pass the required ATS scenarios in the test environment first, and run a small live batch before you send the full volume.

Skip the File Conversion Entirely: The e1099f Advantage

Everything above is the work of migrating yourself — the new TCC, the format conversion, and the testing. There is a second path that sidesteps most of it: file through an IRS-authorized provider that already holds an IRIS TCC and accepts the files you already produce.

No 45-day wait

We already hold an IRIS TCC, so you create an account and file your data today — no new application, no suitability review, and no ID.me.

Keep your FIRE files

Import the FIRE-format files you already produce, and we reshape them into validated IRIS data automatically, so the conversion stage disappears.

Validation & testing handled

Every record is checked against the IRS business rules before submission, ATS is already passed on our side, and you get a receipt back.

If you’d rather not re-platform under deadline pressure, this is the fastest compliant route from FIRE to IRIS — CF/SF included.

Frequently Asked Questions

Can I upload my existing FIRE files directly to IRIS?
No. FIRE files are fixed-width Pub 1220 records, while IRIS reads a CSV mapped to its template on the Portal or named XML elements over A2A. The data has to be converted into the target format first.
Does my FIRE TCC work for IRIS?
No. FIRE and IRIS are separate systems with separate Transmitter Control Codes and no conversion path between them, so you must apply for a new IRIS TCC through IRS e-Services.
When does the FIRE system shut down?
The IRS plans to retire FIRE after the tax year 2026 season, accepting its final submissions and then shutting down following December 31, 2026. Confirm the current dates on the IRS FIRE system page before you rely on it as a fallback.
How long does the IRIS TCC approval take?
The suitability review runs a minimum of 45 business days and cannot be expedited. With ID.me and the application on top of that, plan for roughly two to four months end to end.
Do I have to use A2A, or can I just use the Portal?
Either works. The Taxpayer Portal, through manual entry or CSV upload, needs no developers and suits low-to-mid volume. A2A sends XML over an API and suits high-volume filers, but it adds a schema build and mandatory ATS testing.
Do I need ID.me to migrate?
Yes. The Responsible Official and every authorized user must complete ID.me identity verification through e-Services before the IRIS TCC application can proceed.
What is ATS, and do I have to pass it?
The Assurance Testing System is the IRS sandbox where A2A filers prove their XML is well-formed before going live. A2A filers must pass it; Portal filers do not use ATS at all.
Will my Combined Federal/State Filing still work after I migrate?
IRIS supports Combined Federal/State Filing for eligible forms and states, but the CF/SF election must be set on the first submission. Treat it as part of the migration, not an afterthought.
Is there a fee to get an IRIS TCC?
The IRS does not charge for the TCC itself. Your real costs are the time to apply and, for A2A filers, the development and ATS testing effort.
Do I have to migrate at all if I file through e1099f?
No. e1099f files under its own IRIS TCC and converts your FIRE-format files for you, so you skip the new application, the format conversion, and ATS testing entirely.
DM
Dariel Montesino
Founder, e1099f · Reviewed by a licensed CPA

Dariel writes e1099f’s technical coverage of the FIRE→IRIS migration, drawing on IRS Publications 5717–5719 and hands-on IRIS A2A integration work.

Not tax advice. This guide is general information about IRS procedures and may change as the IRS updates IRIS and finalizes the FIRE retirement timeline. Confirm current requirements in the official IRS publications linked above, and consult a tax professional for your situation.

Skip the file conversion. Migrate to IRIS in minutes.

Sign up, import the FIRE files you already produce, and we convert and file them through our IRIS TCC. Free to start — no credit card.

An unhandled error has occurred. Reload ×

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.