---
title: "Submit Tin Verification"
method: POST
path: "/tin_verifications"
tags: ["TIN Verification"]
---

# Submit Tin Verification

`POST /tin_verifications`

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.

## Request body

- V1TINVerificationRequest — Request model for TIN verification operations. This model defines the structure for TIN verification API requests.
  - `name` string, required — The name of the business to verify.
  - `tin` string, required — The TIN/EIN to verify.
  - `address` string, nullable — The address of the business to verify.

## Response `200`

Successful Response

- V1TINVerificationResponse — Response model for TIN verification data. This model defines the structure for TIN verification API responses.
  - `id` string, uuid, required — The unique identifier of the TIN verification request.
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `name` string, required — The name inputted in the search.
  - `tin` string, required — The TIN inputted in the search.
  - `address` string, nullable — The address inputted in the search.
  - `tin_matched` boolean, nullable — Indicates whether the inputted TIN/EIN was a match, per the IRS.
  - `warnings` string[] — Any warnings that occurred.
  - `created_at` string, date-time, required — The date and time when the TIN verification request was created.
  - `tin_match_type` 'SSN' | 'EIN' | 'UNKNOWN'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)