TIN ComplianceA resource from TIN Comply
Step by step

IRS bulk TIN matching, step by step: file format, upload, results

The IRS Bulk TIN Session checks up to 100,000 name/TIN pairs from one text file and returns a results file to your e-Services secure mailbox within 24 hours. This walkthrough shows every screen in the live IRS system, the exact file format, what the results file looks like, and how to turn the codes into a work list.

Who this is for payers with e-Services TIN Matching access and a vendor file to verifyUpdated September 22, 2026Sources IRS e-Services TIN Matching; Publication 2108A

Step 1: Build the input file

The bulk session accepts a plain-text file (.txt), one record per line, fields separated by semicolons, no header row:

ColumnContentRules
1TIN type1 = EIN, 2 = SSN, 3 = unknown. Use 1 or 2 when you know it; 3 returns a less specific code.
2TINNine digits, no hyphens or spaces. Watch for leading zeros stripped by Excel.
3NameLast name or business name, up to 40 characters; letters, numbers, spaces, hyphens and ampersands only (no apostrophes, commas or periods).
4Account number (optional)Anything you want carried through to the results, such as your vendor ID, so you can match rows back.
Sample IRS bulk TIN matching input file with three semicolon-delimited records
The input file. Three test records: type 3 (unknown), type 2 (SSN) and type 1 (EIN), each with a name and an account label. Save as .txt.

Files of up to 100,000 records are accepted. Larger vendor files are split; keep the account column so the pieces reconcile.

Step 2: Check the file before you submit

Most bulk problems are format problems, and the IRS reports them as code 1 (TIN missing or not nine digits) or code 4 (invalid request) after the 24-hour wait, one record at a time. It is worth validating the file first. TIN Comply, which publishes this site, offers a free, browser-only IRS bulk TIN file validator that checks delimiters, TIN length and characters, name characters and length, TIN types and duplicates, and can write out a corrected file. Nothing is uploaded; the check runs in the page.

TIN Comply IRS bulk TIN file validator showing three records passing all format checks with the IRS submission checklist
The file validator. The same three records pass all ten format checks. On a real vendor export this is where hyphenated SSNs, stripped leading zeros and 41-character names get caught before they cost a day.

Step 3: Upload the file

IRS Bulk TIN Session request page with the input file chosen and an optional notification email entered
The bulk request. Choose the .txt file and, optionally, an email address for the notification if it should go somewhere other than the address on your e-Services application. Submit.

Step 4: The tracking number and the email

IRS Bulk TIN Session results page confirming receipt with a date and tracking number
Receipt. The IRS returns a tracking number immediately. Record it against the file name; the results arrive under that number, and if you submit several files a day it is the only way to tell them apart.
IRS e-Services email notice stating that tax information was placed in the secure mailbox and will be purged
The notification. Usually within a few hours, well inside the 24-hour promise. Note the purge rule: the results are deleted 3 days after you open them or 30 days if you never do, and there is no re-download. Save the file the first time.

Step 5: Retrieve the results from the secure mailbox

IRS e-Services secure mailbox inbox listing one unread message with the bulk TIN matching results attachment
The secure mailbox. Inside e-Services, not your email. The message subject is your file name with the tracking number appended.
IRS e-Services message showing the attached TIN matching result file with View and Download links
The message. Download the attachment rather than viewing it; the download is the file you will keep. Larger files take a moment to retrieve.

Step 6: Read the results file

IRS bulk TIN matching results file: the original three records with a result code appended to each line
The results file. Your input file, returned with a fifth field: the result code. Here the unknown-type record came back 3 (name and TIN exist but not together) and the SSN and EIN records came back 2 (TIN not issued), which is what test data should produce.

The codes are the same nine used by the interactive session: 0, 6, 7 and 8 are matches; 1 and 4 are format problems in your file; 2 and 3 are payee problems that need a corrected W-9; 5 is a duplicate. The TIN matching guide explains each one and the usual cause.

Step 7: Turn the codes into a work list

A results file for a real vendor base has thousands of lines, and the useful questions are the aggregate ones: what share matched, how many need a W-9 request, how many are file-format fixes you can make yourself, and which vendors to contact first. TIN Comply's free IRS bulk TIN results analyzer reads the results file in the browser and produces that summary, with the per-vendor list exportable to CSV for the AP team.

TIN Comply IRS bulk TIN results analyzer showing match rate, a result-code breakdown table with recommended actions, and result distribution bars
The results analyzer. Match rate, the breakdown by code with the action for each, and the distribution by TIN type. On this three-record test file the risk score is deliberately alarming; on a real file the number to watch is the code-3 count, because each one is a B-Notice waiting to happen.

From here the process is the one in the solicitation guide: send the W-9 request, log the date, re-match when the corrected form arrives, and file with the pair that returned 0.

Questions people ask

How long do bulk results really take?

The IRS commits to 24 hours. In practice files submitted during the business day often come back the same afternoon; files submitted late on Friday can wait until Monday.

Can I submit a CSV?

No. The file must be .txt with semicolon delimiters and no header row. A CSV renamed to .txt still fails on the commas.

Why did a correct vendor come back code 3?

Usually the name: a sole proprietor's business name where the person's name belongs, a trade name instead of the legal name, or a single-member LLC using the owner's SSN under the LLC name. See which name goes on the W-9.

Do I need the bulk session if I use a service?

Services such as TIN Comply run the same IRS match through their own access and return results in seconds with the explanation attached, so most of their customers never open e-Services. The bulk session is the right tool for a payer that already has access and matches once or twice a year.