TIN Verification Task
An Tax Identification Number (TIN) is used by the Internal Revenue Service (IRS) to uniquely identify a tax paying entity. It can be an Employer Identification Number (EIN), a Social Security Number (SSN), an Individual Taxpayer Identification Number (ITIN), as well as other less common TIN types.
The tin_verification task verifies that the submitted EIN is valid and that it matches the business name submitted.
The tin_verification task will return one of the following responses:
| Status | Result | Reason |
|---|---|---|
| Success | tin_verified | TIN and Name combination matches IRS records |
| Failure | error | Invalid TIN |
| Failure | not_completed | IRS is unavailable |
| Failure | not_completed | Duplicate TIN matching request |
| Failure | tin_not_verified | TIN and Name combination does not match IRS records |
| Failure | tin_not_verified | TIN entered is not currently issued |
Gaining Access to the TIN Verification Task
The TIN verification task is an optional add-on that is not included in a package.
Please contact us to have it added to your account.
Once the task has been added to your account, you can retrieve it by passing tin_verification in the attrs parameter and passing a 9-digit string in the tin field.