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.

curl \
  --request POST \
  --url https://sandbox-api.withabound.com/v4/tin-verifications \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "name": "Ada Lovelace",
    "tin": "000000000"
  }'

Verifying an businsess 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.

curl \
  --request POST \
  --url https://sandbox-api.withabound.com/v4/tin-verifications \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  -data '{
    "name": "Hooli Inc.",
    "tin": "111111111"
  }'

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.

{
  "id": "tinVerificationId_sample41SD71AV8f",
  "createdAt": "2023-01-01T00:00:00.000Z",
  "status": "MATCH",
  "name": "Ada Lovelace",
  "tin": "*******00",
  "tinType": "INDIVIDUAL",
  "tinFingerprint": "tinFingerprint_samplehy2BWO6JJG"
}