v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

TIN Verification

Get Tin Verification

Retrieve a TIN Verification Request by ID.

get/tin_verifications/{id}

Path parameters

idstring uuid required

The unique identifier of the TIN verification request to retrieve.

Example:412a49b5-7466-426b-bf1e-081b00b54576

The unique identifier of the TIN verification request to retrieve.

Response

Successful Response

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 response

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