v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

TIN Verification

Submit Tin Verification

Search for a TIN (Tax Identification Number) against IRS records by name.

Note: An error will be raised if the IRS validation service is experiencing an outage. Check status.baselayer.com for service updates.

post/tin_verifications

Request body

namestring required

The name of the business to verify.

tinstring required

The TIN/EIN to verify.

addressstring nullable

The address of the business to verify.

Example request

{
  "name": "Acme Corporation",
  "tin": "123456789",
  "address": "123 Main St, Anytown, USA"
}

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