v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Webhook Events

TINVerification.failed

Emitted when a TIN verification has failed.

postWebhookTINVerification.failed

Payload

idstring uuid required

The unique identifier of the TIN verification request.

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

namestring required

The name inputted in the search.

tinstring required

The TIN inputted in the search.

addressstring nullable

The address inputted in the search.

tin_matchedboolean nullable

Indicates whether the inputted TIN/EIN was a match, per the IRS.

warningsstring[]

Any warnings that occurred.

created_atstring date-time required

The date and time when the TIN verification request was created.

tin_match_type'SSN' | 'EIN' | 'UNKNOWN'

Example payload

{
  "id": "c33e20e9-a17c-4299-9844-f2554d07aab6",
  "name": "Acme Corporation",
  "tin": "123456789",
  "address": "123 Main St, Anytown, USA",
  "tin_matched": true,
  "warnings": [
    "IRS Validation is unavailable."
  ],
  "created_at": "2026-07-16T19:24:27.788814"
}

Response

Successful Response

{"stackTrail":"webhooks:TINVerification.failed:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}