---
title: "TIN Verification"
method: POST
path: "/api/tin/verify"
tags: ["tin"]
---

# TIN Verification

`POST /api/tin/verify`

TIN Verification job

## Headers

- `content-type` string
- `accept` string

## Request body

- TinRequest
  - `firstName` string, required — First name linked to the TIN number in the request. The first 40 characters of the combined first and last names are used in the matching process. Must only contain letters, spaces, hyphens, and ampersands.
  - `lastName` string, required — Last name linked to the TIN number in the request. The first 40 characters of the combined first and last names are used in the matching process. Must only contain letters, spaces, hyphens, and ampersands.
  - `tinType` string, required — ITIN
  - `tin` string, required — The full 9 digits of the TIN in the request. Do not include dashes or spaces.
  - `callbackURL` string, required — Upon completion of a pending job, Vouched will POST the job results to the defined webhook.
  - `phone` string, required — The phone number of the individual for this request. Formatted in E.164 formatting for international numbers including the leading plus sign. For example +12065551111

## Response `200`

Success

- TinResponse
  - `id` string
  - `submitted` string
  - `updatedAt` string
  - `request` object
    - `firstName` string
    - `lastName` string
    - `tinType` string
    - `callbackURL` string
    - `phone` string
  - `result` object
    - `status` string — MATCH | NO_MATCH | PENDING
    - `tinType` string — ITIN

## Other responses

- `400` — InvalidRequestError - The request is invalid.
- `401` — AuthenticationError - The request could not be authenticated.
- `404` — ConnectionError - A connection error occurred while communicating to the Vouched service.
- `429` — TooManyRequestsError - the Vouched service has throttled this request.
- `500` — UnknownSystemError - A unknown system error occurred.

---

[API](https://skmtc.dev/vouched/apis/vouched-api.md) · [All operations](https://skmtc.dev/vouched/apis/vouched-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vouched/vouched-api/revisions/e6b14826bf7f/schema)