https://www.tincomply.com/api/v1/validate/irs-tin-name-matching
The irs-tin-name-matching endpoint is used to validate a Taxpayer Identification Number (TIN) and Name combination against IRS records.
The following parameters are required for a request:
tin – The Taxpayer Identification Number (EIN or SSN).name – The entity or individual name associated with the TIN.The response object is irsTinNameMatchingResult, which contains a result value that indicates the match outcome.
result| Value | Description |
|---|---|
| 2 | TIN entered is not currently issued. |
| 3 | TIN/Name combination does not match IRS records. |
| 6 | TIN/Name combination matches SSN records. |
| 7 | TIN/Name combination matches EIN records. |
| 8 | TIN/Name combination matches both SSN and EIN records. |
{
"tin": "123-12-1234",
"name": "JOHN SMITH"
}
Response:
{
"id": "BZ5CF5Z2q0SwIBmhZylJggxp",
"request": {
"tin": "XXXXX1234",
"name": "JOHN SMITH",
"requestDate": "2025-02-19T20:23:41Z",
"requestedServices": "irs-tin-name-matching"
},
"irsTinNameMatchingResult": {
"message": "TIN and Name combination does not match IRS records",
"result": 3,
"completed": true
}
}