Create a TIN Verification

POST

/v4/tin-verifications

Creates an asynchronous TIN Verification.

Idempotency-KeystringOptional

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

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.

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

Allowed values: MATCHMISMATCHPENDING

The status of the TIN Verification.

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.

tinType"INDIVIDUAL" or "BUSINESS"Optional

Allowed values: INDIVIDUALBUSINESS

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

userIdstringOptional

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

1	curl -X POST https://sandbox-api.withabound.com/v4/tin-verifications \
2	-H "Authorization: Bearer <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "Ada Lovelace",
6	"tin": "000000000"
7	}'

1	{
2	"createdAt": "2024-01-01T00:00:00.000Z",
3	"id": "tinVerificationId_sample41SD71AV8f",
4	"name": "Ada Lovelace",
5	"status": "MATCH",
6	"tin": "*******00",
7	"tinFingerprint": "tinFingerprint_samplehy2BWO6JJG",
8	"tinType": "INDIVIDUAL"
9	}