{
"id": "f5067592-dbb8-4405-a557-6d5056514cae",
"state": "COMPLETED",
"name": "Acme Corporation",
"tin": "123456789",
"created_at": "2026-08-31T10:31:07.816900",
"__event__": {
"type": "TINVerification.completed",
"origin": "api"
},
"address": "123 Main St, Anytown, USA",
"tin_matched": true,
"warnings": [
"IRS Validation is unavailable."
],
"tin_match_type": "SSN"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Business Verification
Tin verification completed
Emitted when a TIN verification has completed.
WEBHOOK
TINVerification.completed
{
"id": "f5067592-dbb8-4405-a557-6d5056514cae",
"state": "COMPLETED",
"name": "Acme Corporation",
"tin": "123456789",
"created_at": "2026-08-31T10:31:07.816900",
"__event__": {
"type": "TINVerification.completed",
"origin": "api"
},
"address": "123 Main St, Anytown, USA",
"tin_matched": true,
"warnings": [
"IRS Validation is unavailable."
],
"tin_match_type": "SSN"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Body
application/json
The unique identifier of the TIN verification request.
Example:
"f5067592-dbb8-4405-a557-6d5056514cae"
The status of the TIN verification request.
Available options:
PENDING, EXECUTING, COMPLETED, FAILED, CANCELLED Example:
"COMPLETED"
The name inputted in the search.
Example:
"Acme Corporation"
The TIN inputted in the search.
Required string length:
9Example:
"123456789"
The date and time when the TIN verification request was created.
Example:
"2026-08-31T10:31:07.816900"
Show child attributes
Show child attributes
The address inputted in the search.
Maximum string length:
500Example:
"123 Main St, Anytown, USA"
Indicates whether the inputted TIN/EIN was a match, per the IRS.
Example:
true
Any warnings that occurred.
Example:
["IRS Validation is unavailable."]
The type of match that occurred.
Available options:
SSN, EIN, UNKNOWN Example:
"SSN"
Response
Successful Response