IRS TIN Matching Endpoint

The irs-tin-name-matching endpoint is used to validate a Taxpayer Identification Number (TIN) and Name combination against IRS records.

https://www.tincomply.com/api/v1/validate/irs-tin-name-matching

Supported Parameters

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.

Response Object

The response object is irsTinNameMatchingResult, which contains a result value that indicates the match outcome.

Possible Values for 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.

Sample Request

{
    "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
    }
}

Related