# Track your IRIS information return filings through an API

> Read your submitted transmissions, their Receipt IDs and transmission statuses, and the errors on each acknowledgment from the IRIS Taxpayer Portal, one API call each. A workflow can check each morning in filing season and email you what came back Rejected.

Page: https://fous.com/automate/iris-taxpayer-portal
Updated: 2026-11-12

Works with your own IRIS Taxpayer Portal account. Fous is an independent product.

## What you can build on the IRIS Taxpayer Portal

### Get submitted transmissions

Reads the table on the View Submitted Forms page: each transmission's Receipt ID, when it was submitted and its Transmission Status.

- Takes: Transmission status (optional), submitted since (optional)
- Returns: Receipt ID, submitted date and time, transmission status

### Read a transmission's acknowledgment

Opens the View Acknowledgment page for one Receipt ID and reads its status and the list of errors with the record each one belongs to.

- Takes: Receipt ID
- Returns: Receipt ID, transmission status, errors, record for each error

### List unsubmitted forms

Reads the Unsubmitted Forms page: forms keyed in or added from a CSV upload that have not been filed yet, with their status and group.

- Takes: Status (optional)
- Returns: Form type, status, group

### Request an automatic extension

Opens Request Automatic Extensions, picks a saved issuer, selects the method of filing and the forms, submits, and reads the approval acknowledgment.

- Takes: Saved issuer, electronic or paper filing, forms
- Returns: Receipt ID, submitted date and time, transmission status

## Automate the IRIS Taxpayer Portal with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Rejected transmissions, with their errors

Starts: Every weekday at 8:00 Eastern time

1. Get the submitted transmissions from the last day.
2. Keep the ones whose status is Rejected, Partially Accepted or Accepted with Errors.
3. For each one, read the acknowledgment's errors and the records they belong to.
4. Email you one list grouped by Receipt ID.

### Forms saved but not yet submitted

Starts: Every Monday at 9:00 Eastern time

1. List the forms on the Unsubmitted Forms page.
2. Stop when there are none.
3. Email you the forms by group and status, In Progress or Ready to Submit.

### Transmission status changes, posted to your system

Starts: Every day at 18:00 Eastern time

1. Get all submitted transmissions.
2. Keep the ones whose transmission status changed since the last run.
3. Post the Receipt ID, submitted date and time and new status to your webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get submitted transmissions” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "la.www4.irs.gov/get_submitted_transmissions",
    "input": {
      "transmission_status": "Rejected",
      "submitted_since": "2027-01-25"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "transmissions": [
      {
        "receipt_id": "2027-0000000000000-a1b2c3d4e",
        "submitted_at": "2027-01-27T14:12:00-05:00",
        "transmission_status": "Rejected"
      },
      {
        "receipt_id": "2027-0000000000000-f5e6d7c8b",
        "submitted_at": "2027-01-26T09:41:00-05:00",
        "transmission_status": "Rejected"
      }
    ],
    "count": 2
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The IRIS Taxpayer Portal’s own options

The IRS offers the IRIS Taxpayer Portal free: you key in forms or upload a CSV and file up to 100 forms per submission. For larger volumes it offers IRIS A2A, an XML channel that needs an A2A TCC, an API Client ID and passing IRIS Assurance Testing System transmissions first. FIRE takes its last filings on November 19, 2026.

| Option | What it covers | What it takes |
| --- | --- | --- |
| IRIS A2A | Bulk filing in XML, including corrections and automatic extensions, up to 100 MB at a time. | An IRIS A2A TCC, an API Client ID with a JWK and an X.509 certificate that is not self-signed, A2A consent and passing ATS. |
| CSV upload in the portal | Adds forms to Unsubmitted Forms from a .csv file: one form type and one tax year per file, up to 100 records. | An IRIS Taxpayer Portal TCC. The uploaded forms still have to be submitted from Unsubmitted Forms. |
| The IRIS Taxpayer Portal by hand | Start New Form, Unsubmitted Forms, View Submitted Forms, Request Automatic Extensions, Issuer Management and recipient copies. | An IRS account through ID.me or Login.gov and an IRIS TCC, which takes up to 45 calendar days. |

Read on November 12, 2026: [E-file information returns with IRIS](https://www.irs.gov/filing/e-file-information-returns-with-iris), [IRIS 101 presentation (August 2025)](https://www.irs.gov/pub/irs-efile/iris-101-07292025.pdf), [Filing information returns electronically (FIRE)](https://www.irs.gov/e-file-providers/filing-information-returns-electronically-fire).

## Signing in to the IRIS Taxpayer Portal

You sign in to the IRIS Taxpayer Portal with your own IRS account through ID.me or Login.gov, and only once your organization has an IRIS Taxpayer Portal TCC. Every Responsible Official, Authorized Delegate and Contact verifies their own identity. With Fous you sign in once through the portal's own sign-in with your own account: the login is sealed with AES-256.

## Worth knowing

- **The TCC comes first**: A Responsible Official starts the IRIS Application for TCC, every Responsible Official signs it, and the IRS allows up to 45 calendar days. A FIRE TCC does not work in IRIS.
- **Uploaded is not filed**: A CSV upload only adds forms to the Unsubmitted Forms page. Nothing reaches the IRS until you submit them there and get a Receipt ID.
- **Corrections, never deletions**: The IRS cannot delete a transmission. Only transmissions in Accepted or Accepted with Errors can be corrected, and a duplicate is fixed by a correction that zeroes out every money amount.
- **Recipient copies arrive as a Zip**: Downloaded recipient copies appear under Notifications as a Zip with a PDF and a Recipient Checklist .csv for each record, and can take up to 10 minutes to show.

## More in Government: US federal

- [BSA E-Filing System](https://fous.com/automate/bsa-e-filing-system.md)
- [FINRA Gateway](https://fous.com/automate/finra-gateway.md)
- [PostalOne](https://fous.com/automate/postalone.md)
- [USPS Business Customer Gateway](https://fous.com/automate/usps-business-customer-gateway.md)
- [Invoice Processing Platform](https://fous.com/automate/invoice-processing-platform.md)
- [FMCSA Drug & Alcohol Clearinghouse](https://fous.com/automate/fmcsa-drug-and-alcohol-clearinghouse.md)
- [Wide Area Workflow](https://fous.com/automate/wide-area-workflow.md)
- [E-Verify](https://fous.com/automate/e-verify.md)
- [EPA Central Data Exchange](https://fous.com/automate/epa-central-data-exchange.md)
- [SAM.gov](https://fous.com/automate/sam-gov.md)
- [CM/ECF](https://fous.com/automate/cm-ecf.md)
- [EFTPS](https://fous.com/automate/eftps.md)
- [FBI NICS E-Check](https://fous.com/automate/fbi-nics-e-check.md)
- [FLAG](https://fous.com/automate/flag.md)
- [HUD Secure Systems](https://fous.com/automate/hud-secure-systems.md)
- [USCIS online account](https://fous.com/automate/uscis-online-account.md)
- [Motus](https://fous.com/automate/motus.md)
- [TRACS / iMAX](https://fous.com/automate/tracs-imax.md)
- [USPTO Patent Center](https://fous.com/automate/uspto-patent-center.md)
- [EDGAR Filer Management](https://fous.com/automate/edgar-filer-management.md)
- [COD](https://fous.com/automate/cod.md)
- [IRS e-Services](https://fous.com/automate/irs-e-services.md)
- [IRS Tax Pro Account](https://fous.com/automate/irs-tax-pro-account.md)
- [EIV](https://fous.com/automate/eiv.md)
- [USPTO Trademark Center](https://fous.com/automate/uspto-trademark-center.md)
- [SSA Business Services Online](https://fous.com/automate/ssa-business-services-online.md)
- [NetDMR](https://fous.com/automate/netdmr.md)

Other industries: [OpenGov Procurement](/automate/opengov-procurement), [MyTax Illinois](/automate/mytax-illinois), [bizfile Online](/automate/bizfile-online), [モノタロウ](/automate/monotaro), [e-staffing](/automate/e-staffing), [NHSBSA Manage Your Service](/automate/nhsbsa-manage-your-service).

## Frequently asked questions

### Does the IRIS Taxpayer Portal have an API?

Not the portal itself, but IRIS has an A2A channel for software. It takes XML transmissions and needs an A2A TCC, an API Client ID with a certificate, A2A consent and passing the IRIS Assurance Testing System first. The portal is the free option for smaller volumes, up to 100 forms per submission.

### How do I find out why a transmission was rejected?

Open View Submitted Forms and select the transmission's status. The View Acknowledgment page shows whether it was Accepted, Accepted with Errors, Partially Accepted or Rejected, and lists each error with the record it belongs to.

### Can I file more than 100 forms in the portal?

Yes, in several submissions. Each submission and each CSV file holds up to 100 forms, and a CSV file holds one form type and one tax year. For bulk filing the IRS points to IRIS A2A, which takes up to 100 MB at a time.

### When does FIRE stop taking filings?

The last day to file information returns through FIRE is November 19, 2026, at 3 p.m. Eastern time. After January 1, 2027, IRIS is the only electronic filing system for information returns, and a FIRE TCC cannot be used in IRIS.

### Is Fous affiliated with the Internal Revenue Service?

No. Fous is an independent product. You use it with your own IRS account and IRIS TCC, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of IRIS Taxpayer Portal (Internal Revenue Service). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.