Create a TIN Verification

The following is an example of creating a TIN Verification. Read the full TIN Verification reference here.

Verifying an individual entity

To create a TIN Verification for an individual you’ll need both the first and last name together in the name field and their Social Security Number (SSN) in the tin field.

1
curl \
2
  --request POST \
3
  --url https://sandbox-api.withabound.com/v4/tin-verifications \
4
  --header 'accept: application/json' \
5
  --header 'content-type: application/json' \
6
  --data '{
7
    "name": "Ada Lovelace",
8
    "tin": "000000000"
9
  }'

Verifying an business entity

To create a TIN Verification for a business you’ll need both the legal business name (not the DBA) in the name field and the Employer Identification Number (EIN) in the tin field.

1
curl \
2
  --request POST \
3
  --url https://sandbox-api.withabound.com/v4/tin-verifications \
4
  --header 'accept: application/json' \
5
  --header 'content-type: application/json' \
6
  -data '{
7
    "name": "Hooli Inc.",
8
    "tin": "111111111"
9
  }'

Response

The response will contain a unique tinVerificationId, the createdAt timestamp, a status of the verification, the masked version of the tin you sent in the request and a tinFingerprint. Read more about tinFingerprints here.

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