Skip to main content
POST
Submit Tin Verification

Authorizations

X-API-Key
string
header
required

Headers

Idempotency-Key
string | null

An opaque key, ideally a UUID, that makes this request safe to retry. A second request with the same key, path, query and body answers with the resource the first one created, marked Idempotent-Replayed: true, instead of creating another; a sync request that finds it still running waits for it. The same key with a different request is refused with 422. Keys are scoped to your application and to this resource type, and are kept for the life of the resource.

Body

application/json

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.

Maximum string length: 255
Example:

"Acme Corporation"

tin
string
required

The TIN/EIN to verify.

Required string length: 9
Example:

"123456789"

address
string | null

The address of the business to verify.

Maximum string length: 500
Example:

"123 Main St, Anytown, USA"

Response

Successful Response

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.

Example:

"d2682fdb-46fe-429c-8111-dee6db9d0eb3"

state
enum<string>
required

The status of the TIN verification request.

Available options:
PENDING,
EXECUTING,
COMPLETED,
FAILED,
CANCELLED
Example:

"COMPLETED"

name
string
required

The name inputted in the search.

Example:

"Acme Corporation"

tin
string
required

The TIN inputted in the search.

Required string length: 9
Example:

"123456789"

created_at
string<date-time>
required

The date and time when the TIN verification request was created.

Example:

"2026-10-29T05:44:48.448457"

idempotency_key
string | null

The Idempotency-Key header the request that created this resource carried, if any.

address
string | null

The address inputted in the search.

Maximum string length: 500
Example:

"123 Main St, Anytown, USA"

tin_matched
boolean | null

Indicates whether the inputted TIN/EIN was a match, per the IRS.

Example:

true

warnings
string[]

Any warnings that occurred.

Example:
tin_match_type
enum<string> | null

The type of match that occurred.

Available options:
SSN,
EIN,
UNKNOWN
Example:

"SSN"