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.
tinTypeenum or null

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

Allowed values:
userIdstring or null

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

Errors