API ReferenceTIN Verifications

Create a TIN Verification

Creates an asynchronous TIN Verification.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Idempotency-KeystringOptional

The unique key used to identify a request that has already been processed.

Request

This endpoint expects an object.
namestringRequired

The legal name (first + last) or business name.

tinstringRequired=9 characters

The tax identification number, commonly referred to as a TIN. No hyphens. Numerical digits only.

userIdstringOptional

The unique identifier for a single end-user of your application.

Response

OK

createdAtdatetime

The creation date and time of the TIN Verification in ISO 8601 format.

idstring

The unique identifier for this TIN Verification.

namestring

The legal name (first + last) or business name.

statusenum

The status of the TIN Verification.

Allowed values:
tinstring=9 characters

The tax identification number, commonly referred to as a TIN. No hyphens. Numerical digits only.

tinFingerprintstring

The fingerprint for this TIN Verification.

tinTypeenumOptional

The type of the TIN. INDIVIDUAL refers to SSNs, ITINs, or ATINs. While BUSINESS refers to EINs.

Allowed values:
userIdstringOptional

The unique identifier for a single end-user of your application.

Errors