{
"id": "68c87dd8-fb8f-4697-a683-33d0ad9fca17",
"state": "COMPLETED",
"name": "Acme Corporation",
"tin": "123456789",
"created_at": "2026-10-22T15:43:38.478861",
"__event__": {
"type": "TINVerification.submitted",
"origin": "api"
},
"idempotency_key": "<string>",
"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 submitted
Emitted when a TIN verification has been submitted for processing.
WEBHOOK
TINVerification.submitted
{
"id": "68c87dd8-fb8f-4697-a683-33d0ad9fca17",
"state": "COMPLETED",
"name": "Acme Corporation",
"tin": "123456789",
"created_at": "2026-10-22T15:43:38.478861",
"__event__": {
"type": "TINVerification.submitted",
"origin": "api"
},
"idempotency_key": "<string>",
"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:
"68c87dd8-fb8f-4697-a683-33d0ad9fca17"
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-10-22T15:43:38.478861"
Show child attributes
Show child attributes
The Idempotency-Key header the request that created this resource carried, if any.
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