Overview

Use this method to get the data extracted from the external sources using the applicant TIN (SSN).

Response explained

The response represents a singleton list of checks.

The root variables are the core TIN check result data items. Some of them may include nested attributes and element fields.

Field	Type	Description
`answer`	String	Сheck answer: `GREEN` — the check has passed successfully. Data found in the database and matched the applicant data. `RED` — the check shows a high risk indication. Data found but the applicant data does not match the database record.
`checkType`	String	Indicates that it is a `TIN` check type.
`createdAt`	Date	Date and time (UTC) of the latest TIN check result.
`id`	String	Unique identifier of the check.
`inputDoc`	Object	Represents the data used for the TIN check.
`extractedDoc`	Object	External check source data.
`tinCheckInfo`	Object	Includes TIN check results.

The following table explains the inputDoc attributes representing the data taken from the provided document.

Field	Type	Description
`idDocType`	String	A type of the document provided for verification. For example, `TAX_PAYER_NUMBER_DOC`, `ID_CARD`, `PASSPORT`, `DRIVERS`.
`country`	String	Alpha-3 country code (for example, `DEU`, `GBR`, `ARG`, and so on).
`firstName`	String	Applicant first name as stated in the document.
`middleName`	String	Applicant middle name as stated in the document.
`lastName`	String	Applicant last name as stated in the document.
`number`	String	TIN document number.
`dob`	Date	Applicant date of birth specified in the provided document.

The extractedDoc object includes the data obtained from the external source during the TIN check.

Field	Type	Description
`country`	String	Alpha-3 country code (for example, `DEU`, `GBR`, `ARG`, and so on).
`firstName`	String	Applicant first name.
`middleName`	String	Applicant middle name.
`lastName`	String	Applicant last name.
`addresses`	List of Objects	The list of addresses extracted from the external check sources.

The following table explains the addresses element fields containing the applicant address details extracted from external sources.

Field	Type	Description
`street`	String	The street where the applicant lives and/or is registered.
`streetEn`	String	Automatic transliteration of the applicant street into Latin.
`subStreet`	String	Additional information related to the applicant street. This could be a house number or any other details.
`state`	String	The state, region, district, county or another territorial entity inside a country, if applicable.
`stateEn`	String	Automatic transliteration of the applicant state, region, district, county, or another territorial entity inside a country into Latin.
`buildingNumber`	String	Building number.
`town`	String	The city, town, or another settlement where the applicant lives and/or is registered.
`townEn`	String	Automatic transliteration of the city, town, or another settlement where the applicant lives and/or is registered into Latin.
`postCode`	String	Address postal code.
`startDate`	Date	The date of starting using the address as residential.
`endDate`	Date	The date of changing the residential address.
`country`	String	Alpha-3 country code (for example, `DEU`, `GBR`, `ARG`, and so on).
`formattedAddress`	String	Address in an human-readable format.
`providedLocationPosition`	Object	Contains the `locationCoords` object that includes geographical coordinates — the position's latitude and longitude in decimal degrees.

The following table describes the tinCheckInfo attributes representing the TIN check results.

Field	Type	Description
`answer`	String	TIN check answer: `GREEN` — approved. `RED` — rejected.
`tinValidity`	String	Indicates the TIN validity check result: `GREEN` — valid. `RED` — invalid.
`personDataMatchFound`	String	Indicates whether the check found the person data match in accordance with the provided document: `GREEN` — valid. `RED` — invalid.