v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

TIN Verification

List Tin Verifications

List all Federations that the authenticated actor has access to.

get/tin_verifications

Query parameters

limitinteger

offsetinteger

qstring nullable

A search query to limit the TIN Verifications returned by matching on ID, name, or external ID.

Example:Acme, Inc.

A search query to limit the TIN Verifications returned by matching on ID, name, or external ID.

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