USA

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",
        "phone": "+12109041086"
      },
      "extractedDoc": {
        "country": "USA",
        "idDocType": "TAX_PAYER_NUMBER_DOC",
        "firstName": "Andromache",
        "lastName": "Minshaw",
        "phone": "12109041086",
        "email": "[email protected]",
        "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"
      }
    }
  ]
}
// RED - data not found

{
  "checks": [
    {
      "answer": "RED",
      "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",
        "dob": "1995-01-20",
        "phone": "+12109041086"
      },
      "tinCheckInfo": {
        "answer": "RED",
        "tinValidity": "RED",
        "personDataMatchFound": null
      },
      "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",
        "lastName": "Doe",
        "number": "0309",
        "dob": "1995-01-11",
        "phone": "+12109041086"
      },
      "extractedDoc": {
        "country": "USA",
        "idDocType": "TAX_PAYER_NUMBER_DOC",
        "firstName": "Andromache",
        "lastName": "Minshaw",
        "phone": "12109041086",
        "email": "[email protected]",
        "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"
      ]
    }
  ]
}