This page provides examples of the TIN
check response for the USA.
SSN Verification (usa_gov_ssn)
// GREEN — successful check.
{
"checks": [ {
"answer": "GREEN",
"checkType": "TIN",
"createdAt": "2024-05-20 15:00:11",
"id": "67ccf147-7eee-4527-a61c-3cdbd21af028",
"inputDoc": {
"idDocType": "TAX_PAYER_NUMBER_DOC",
"country": "USA",
"firstName": "JOHN",
"lastName": "SMITH",
"number": "123456789",
"dob": "1971-01-01"
},
"extractedDoc": {
"firstName": "JOHN",
"middleName": "T",
"lastName": "SMITH",
"addresses": [ {
"flatNumber": "16",
"street": "12306 CORIDAN DR",
"streetEn": "12306 CORIDAN DR",
"state": "TX",
"stateEn": "TX",
"buildingNumber": "12306",
"town": "AUSTIN",
"townEn": "AUSTIN",
"postCode": "78727-7034",
"startDate": "1990-01-01 00:00:00",
"endDate": "1995-12-31 00:00:00",
"country": "USA",
"formattedAddress": "12306 CORIDAN DR APT 16, AUSTIN, TX 78727-7034",
"providedLocationPosition": {
"locationCoords": {
"lat": 30.436224,
"lon": -97.742058
}
}
}, {
"street": "6 JENNA PLAZA",
"streetEn": "6 JENNA PLAZA",
"state": "NY",
"stateEn": "NY",
"buildingNumber": "6",
"town": "NEW YORK CITY",
"townEn": "NEW YORK CITY",
"postCode": "10009",
"startDate": "1996-01-01 00:00:00",
"endDate": "2024-04-18 00:00:00",
"country": "USA",
"formattedAddress": "6 JENNA PLAZA, NEW YORK CITY, NY 10009",
"providedLocationPosition": {
"locationCoords": {
"lat": 31.233104,
"lon": -90.455543
}
}
} ]
},
"tinCheckInfo": {
"answer": "GREEN",
"tinValidity": "GREEN",
"personDataMatchFound": "GREEN"
}
} ]
}
// RED — data was found but there are violations.
{
"checks": [ {
"answer": "RED",
"checkType": "TIN",
"createdAt": "2024-05-21 08:58:25",
"id": "0eab9617-9914-45db-962e-039c7cf8e62f",
"inputDoc": {
"idDocType": "TAX_PAYER_NUMBER_DOC",
"country": "USA",
"firstName": "JOHN",
"lastName": "DOE",
"number": "123456789",
"dob": "1990-01-01"
},
"extractedDoc": {
"firstName": "JOHN",
"lastName": "SMITH",
"addresses": [ {
"flatNumber": "16",
"street": "12306 CORIDAN DR",
"state": "TX",
"buildingNumber": "12306",
"town": "AUSTIN",
"postCode": "78727-7034",
"startDate": "1990-01-01 00:00:00",
"endDate": "1995-12-31 00:00:00",
"country": "USA",
"formattedAddress": "12306 CORIDAN DR APT 16, AUSTIN, TX 78727-7034",
"providedLocationPosition": {
"locationCoords": {
"lat": 30.436224,
"lon": -97.742058
}
}
} ]
},
"tinCheckInfo": {
"answer": "RED",
"tinValidity": "GREEN",
"personDataMatchFound": "RED"
},
"violations": [ "BDATE_MISMATCH", "NAME_MISMATCH" ]
} ]
}
// RED — data not found.
{
"checks": [ {
"answer": "RED",
"checkType": "TIN",
"createdAt": "2024-05-21 08:59:31",
"id": "f06b965c-da27-4a23-8604-0c32f3eb0892",
"inputDoc": {
"idDocType": "TAX_PAYER_NUMBER_DOC",
"country": "USA",
"firstName": "JOHN",
"lastName": "DOE",
"number": "000000000",
"dob": "1990-01-01"
},
"tinCheckInfo": {
"answer": "RED",
"tinValidity": "RED",
"personDataMatchFound": "RED"
}
} ]
}
SSN Verification (usa_tel_phone)
// GREEN — successful check.
{
"checks" : [ {
"answer" : "GREEN",
"checkType" : "TIN",
"createdAt" : "2024-05-24 13:54:37",
"id" : "f627a790-efa0-4a7e-9441-78d7dff298c7",
"inputDoc" : {
"idDocType" : "TAX_PAYER_NUMBER_DOC",
"country" : "USA",
"number" : "0309",
"dob" : "1995-01-20"
},
"extractedDoc" : {
"country" : "USA",
"idDocType" : "TAX_PAYER_NUMBER_DOC",
"firstName" : "Andromache",
"lastName" : "Minshaw",
"phone" : "12109041086",
"email" : "aminshaw15@digg.com",
"dob" : "1995-01-20",
"addresses" : [ {
"street" : "6 Jenna Plaza",
"streetEn" : "6 Jenna Plaza",
"state" : "OH",
"stateEn" : "OH",
"town" : "New York City",
"townEn" : "New York City",
"postCode" : "10009",
"country" : "USA",
"formattedAddress" : "6 Jenna Plaza, New York City, Ohio, United States of America, 10009"
} ],
"tin" : "602410309"
},
"tinCheckInfo" : {
"answer" : "GREEN",
"tinValidity" : "GREEN",
"personDataMatchFound" : "GREEN"
}
} ]
}
// YELLOW - data not found.
{
"checks" : [ {
"answer" : "YELLOW",
"checkType" : "TIN",
"createdAt" : "2024-05-24 13:58:51",
"id" : "dda5972a-335d-4881-9590-cf5cae9fa00a",
"inputDoc" : {
"idDocType" : "TAX_PAYER_NUMBER_DOC",
"country" : "USA",
"number" : "0000"
},
"tinCheckInfo" : {
"answer" : "YELLOW",
"tinValidity" : "YELLOW",
"personDataMatchFound" : "GREEN"
},
"violations" : [ "DATA_NOT_FOUND" ]
} ]
}
// RED - data was found but there are violations (name mismatch, dob mismatch.
{
"checks" : [ {
"answer" : "RED",
"checkType" : "TIN",
"createdAt" : "2024-05-24 14:21:57",
"id" : "551955a1-7afe-40f6-b230-b9e7bbf648a1",
"inputDoc" : {
"idDocType" : "TAX_PAYER_NUMBER_DOC",
"country" : "USA",
"firstName" : "John",
"number" : "0309",
"dob" : "1995-01-11"
},
"extractedDoc" : {
"country" : "USA",
"idDocType" : "TAX_PAYER_NUMBER_DOC",
"firstName" : "Andromache",
"lastName" : "Minshaw",
"phone" : "12109041086",
"email" : "aminshaw15@digg.com",
"dob" : "1995-01-20",
"addresses" : [ {
"street" : "6 Jenna Plaza",
"state" : "OH",
"town" : "New York City",
"postCode" : "10009",
"country" : "USA",
"formattedAddress" : "6 Jenna Plaza, New York City, Ohio, United States of America, 10009"
} ],
"tin" : "602410309"
},
"tinCheckInfo" : {
"answer" : "RED",
"tinValidity" : "GREEN",
"personDataMatchFound" : "RED"
},
"violations" : [ "NAME_MISMATCH", "BDATE_MISMATCH" ]
} ]
}