Bulk TIN matching: the file and its limits.
How the IRS bulk file is laid out, how big it can be and what comes back.
A bulk TIN Matching request is a plain.txt file with one name and TIN per line, up to 100,000 lines. Each line holds a TIN type, the nine-digit TIN, the name and an optional account number, separated by semicolons. The IRS returns the file to your secure mailbox within 24 hours, with a result code on each line.
How is each line laid out?
| Field | What goes in it |
|---|---|
| TIN type | 1 for an EIN, 2 for an SSN, 3 if you don't know |
| TIN | The nine-digit number, with no dashes |
| Name | Up to 40 letters and numbers; no special characters except hyphens and ampersands |
| Account number | Optional, up to 20 letters and numbers, for your own reference |
What comes back?
Through the IRS TIN Matching API, a bulk request takes the same lines, up to 100,000, and the IRS emails when the results are ready, within 24 hours (IRS e-Services TIN Match API User Guide).
Each line comes back with a code from 0 to 8. When the TIN type is 3, codes 6, 7 and 8 tell you whether the name and TIN matched as an SSN, an EIN or both. A repeated name and TIN in the same request comes back as a duplicate. See IRS TIN Matching codes 0 to 8.
How does a bulk check work in Check?
Upload a spreadsheet of names, TINs and TIN types, up to 10,000 rows. We check the format before we send it, show the price first, and email you when all the answers are back. A row that can't be checked isn't charged. Bulk checks are on the Plus and Professional plans.
Plain Dot does not give tax or legal advice. For advice about your situation, ask a tax professional.
Questions
How many TINs can one bulk file hold?
Up to 100,000 name and TIN combinations in the IRS file. A Check bulk upload holds up to 10,000 rows.
How long does a bulk file take?
The IRS returns it within 24 hours.
What TIN type do I use if I don't know it?
Type 3, unknown. The IRS checks it as both an SSN and an EIN.
Can the name have punctuation?
Only hyphens and ampersands. Leave out other special characters, such as commas and apostrophes.
What happens to a duplicate line?
It comes back with the duplicate request code instead of a match result.
Is the account number required?
No. It's optional, up to 20 letters and numbers, for your own reference.