BAbaselayer
TIN Verification

List Tin Verifications

List all Federations that the authenticated actor has access to.

get/tin_verifications

Request

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.

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

Changes

No recorded changes to this operation across all 1 revision of this API.