Check TINs and pull transcripts from IRS e-Services

What you can build on IRS e-Services

• Check name and TIN combinations

  Build this

  Enters up to 25 payee name and TIN combinations in Interactive TIN Matching and reads the result IRS gives for each one.

  Takes

  Payee names and TINs, up to 25

  Returns

  Payee name, TIN, TIN type, whether name and TIN match IRS records, checked at

• Get a client transcript from TDS

  Build this

  Requests a transcript for one client in the Transcript Delivery System, such as an account transcript or a wage and income transcript, and reads it.

  Takes

  Client TIN, transcript type, tax period

  Returns

  Transcript type, tax period, client name, line items with their amounts

• List new items in the Secure Object Repository

  Build this

  Reads the mailbox list in the Secure Object Repository, where transcripts and TIN Matching results are delivered.

  Takes

  Received since (optional)

  Returns

  Item name, type, received date, size

• Submit a Bulk TIN Matching file

  Build this

  Uploads a text file of up to 100,000 payee name and TIN combinations to Bulk TIN Matching and reads the confirmation.

  Takes

  Text file of names and TINs

  Returns

  File name, submitted at, number of combinations, confirmation

Automate IRS e-Services 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.

• New payees checked against IRS records

  Build this

  Starts

  When your system calls the workflow's webhook with new payees' names and TINs

  Step 1

  Check each group of 25 new payees with Interactive TIN Matching.

  Step 2

  Keep the combinations that IRS records do not match.

  Step 3

  Email you the list with payee name, TIN and TIN type.

• Wage and income transcripts for every client

  Build this

  Starts

  Every Monday at 8:00

  Step 1

  For each client you name, get the Wage and Income transcript for the last tax year from TDS.

  Step 2

  Keep the transcripts that changed since the last run.

  Step 3

  Email you each changed transcript with its client name, line items and amounts.

• Morning check of the Secure Object Repository

  Build this

  Starts

  Every weekday at 7:00

  Step 1

  List the items in the SOR mailbox.

  Step 2

  Keep the items that were not there on the last run.

  Step 3

  Post each one's name, type and received date 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 “Check name and TIN combinations” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "la.www4.irs.gov/check_name_tin_combinations",
    "input": {
      "payees": [
        {
          "name": "Northwind Supply LLC",
          "tin": "123456789",
          "tin_type": "EIN"
        },
        {
          "name": "Globex Services Inc",
          "tin": "987654321",
          "tin_type": "EIN"
        }
      ]
    }
  }'

{
  "status": "completed",
  "data": {
    "results": [
      {
        "name": "Northwind Supply LLC",
        "tin": "123456789",
        "tin_type": "EIN",
        "matches_irs_records": true
      },
      {
        "name": "Globex Services Inc",
        "tin": "987654321",
        "tin_type": "EIN",
        "matches_irs_records": false
      }
    ],
    "checked_at": "2026-11-12T08:14:00-05:00",
    "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.

IRS e-Services’s own options

The IRS offers APIs for e-Services, covering TIN Matching, the Transcript Delivery System and the Secure Object Repository, to applicants with an approved application for the product and a client ID. TIN Matching also takes bulk text files. Otherwise you use the e-Services tools on screen.

Read on November 12, 2026: Get an API client ID, Taxpayer Identification Number (TIN) Matching, TIN matching tools.

Signing in to IRS e-Services

IRS e-Services signs you in with an IRS account through Login.gov or ID.me, after you verify your identity with a government photo ID. Both ask for a second step, such as an authentication app or a text message. With Fous you sign in through the site's own sign-in with your own account, and the login is sealed with AES-256.

Worth knowing

25 at a time, 999 requests a day

Interactive TIN Matching takes name and TIN combinations in groups of 25 and returns results immediately, with a limit of 999 requests during a 24 hour period.

Bulk results arrive in the SOR

Bulk TIN Matching returns results within 24 hours. They, and transcripts, are retrieved from the Secure Object Repository, so reading results is a separate step from submitting.

Transcripts need an authorization on file

TDS gives transcripts only for clients with a Form 2848 or Form 8821 on file, or Form 8665 for reporting agents. Each request is logged by user name, date and time, transaction ID and taxpayer ID.

Current-year wage data comes in February

The IRS says current-year information on the wage and income transcript is generally available in the first week of February, and shows only documents filed with the IRS.

More in Government: US federal

• BSA E-Filing System
• FINRA Gateway
• PostalOne
• USPS Business Customer Gateway
• Invoice Processing Platform
• FMCSA Drug & Alcohol Clearinghouse
• Wide Area Workflow
• E-Verify
• EPA Central Data Exchange
• SAM.gov
• CM/ECF
• EFTPS
• FBI NICS E-Check
• FLAG
• HUD Secure Systems
• USCIS online account
• IRIS Taxpayer Portal
• Motus
• TRACS / iMAX
• USPTO Patent Center
• EDGAR Filer Management
• COD
• IRS Tax Pro Account
• EIV
• USPTO Trademark Center
• SSA Business Services Online
• NetDMR

Other industries: NC eProcurement, Texas Comptroller Webfile, SIDES E-Response, Uline, SAP Fieldglass, Henry Schein online ordering.