Skip to content

FousIRIS Taxpayer Portal

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.

Start building freeBook a demo

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

    Build this

    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

    Build this

    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

    Build this

    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

    Build this

    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 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

    Build this
    Starts
    Every weekday at 8:00 Eastern time
    Step 1
    Get the submitted transmissions from the last day.
    Step 2
    Keep the ones whose status is Rejected, Partially Accepted or Accepted with Errors.
    Step 3
    For each one, read the acknowledgment's errors and the records they belong to.
    Step 4
    Email you one list grouped by Receipt ID.

  • Forms saved but not yet submitted

    Build this
    Starts
    Every Monday at 9:00 Eastern time
    Step 1
    List the forms on the Unsubmitted Forms page.
    Step 2
    Stop when there are none.
    Step 3
    Email you the forms by group and status, In Progress or Ready to Submit.

  • Transmission status changes, posted to your system

    Build this
    Starts
    Every day at 18:00 Eastern time
    Step 1
    Get all submitted transmissions.
    Step 2
    Keep the ones whose transmission status changed since the last run.
    Step 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, 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.

OptionWhat it coversWhat it takes
IRIS A2ABulk 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 portalAdds 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 handStart 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, IRIS 101 presentation (August 2025), 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

Other industries: OpenGov Procurement, MyTax Illinois, bizfile Online, モノタロウ, e-staffing, NHSBSA Manage Your Service.

Frequently asked questions

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.

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.

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.

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.

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.

Put IRIS Taxpayer Portal behind an API call

Describe one job in Studio and see the method it builds, with 100 credits a month and no credit card, or book a demo and bring the sites your team signs in to.

Start building freeBook a demo

Read nextMotusTRACS / iMAXUSPTO Patent CenterOpenGov ProcurementHow methods workHow workflows run

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.