Retrieve user data

To view all submitted user information related to a session use the resources container.

Document resources

The resources container includes all the document resources.

Node.js
Java
PHP
Python
C#
JSON
Copy

Liveness resources

The resources container also includes all the liveness and face capture resources.

Node.js
Java
PHP
Python
C#
Go
Copy

Passive liveness

Node.js
Java
PHP
Python
C#
Go
Copy

Active liveness

Node.js
Java
PHP
Python
C#
Go
Copy

Retrieve user information

This is the full JSON version of the user's profile using document fields. An explanation of the address format can be found in this section: Attributes explained.

The document_fields media id should be used when an OCR or manual data entry result is successful. The media ID will be updated to the latest result, if you get OCR data back it will relate to the server side extraction. If the data entry goes for a manual check and data is extracted successfully the media ID will also be updated accordingly and point to generated media from a text data check.

The absence of the document fields object would indicate that data did not get extracted from the ID document.

Node.js
Java
PHP
Python
C#
Copy

Example Extractions

GBR Passport
GBR DL
GBR Residence Permit
DEU DL
ESP Passport
US State ID
Copy
Good to know
Not all fields will be available all the time, as not all of them are mandatory.

Retrieve supplementary documents

Supplementary documents will be similarly available as part of the JSON if they have been successfully parsed by either OCR or manual data entry. When retrieving supplementary documents, any document images will appear as 'pages' objects in the JSON whilst uploaded pdfs will be 'file' objects.

Node.js
Java
PHP
Python
C#
Copy

If you have enabled non latin characters Yoti will do its best to provide the latin characters where possible.

Example Extraction

All extractions for supplementary documents will carry the same JSON structure

Phone Bill
Utility Bill
Bank Statement
Copy

Address Formats

Addresses will be returned in 1 of 4 different formats.

Format 1 - UK
Format 2 - India
Format 3 - USA
Format 4 - RoW
Copy
Field nameTypeDescription
address_formatnumberAddressFormat is used to identify which fields may be present in the JSON object. See table below that defines what format is used for each country.
udprnstringUdprn is the Unique Delivery Point Reference Number that identifies a property throughout its lifecycle.
care_ofstringCareOf identifies the owner of the premises.
sub_buildingstringSubBuilding is used when the building is divided into smaller units (e.g. a block of flats) to identify the sub unit.
building_numberstringBuildingNumber is the number of the building.
buildingstringBuilding is the name/number of the building.
streetstringStreet is the name/number of the street the building is on.
landmarkstringLandmark is a description used to describe the location of the building.
address_line1stringAddressLine1 is the first line of the address.
address_line2stringAddressLine2 is the second line of the address.
address_line3stringAddressLine3 is the third line of the address.
address_line4stringAddressLine4 is the fourth line of the address.
address_line5stringAddressLine5 is the fifth line of the address.
address_line6stringAddressLine6 is the sixth line of the address.
localitystringLocality is the area the building is in.
town_citystringTownCity is the town/city/village/hamlet/community/etc. that the building is in.
subdistrictstringSubdistrict is the sub-district the building is in.
districtstringDistrict is the district the building is in.
statestringState is the state/county the building is in.
postal_codestringPostalCode is a code used by the country's postal service to aid in sorting and delivering mail (e.g. postcode, zipcode, pincode).
post_officestringPostOffice is the post office that serves the area the building is in.
country_isostringCountryIso is the country the building is in. In ISO-3166-1 alpha-3 format.
countrystringCountry is the country the building is in. Localised.
formatted_addressstringFormattedAddress is the full address in a single human readable string in a format that is suitable for printing onto an envelope. This field is not required when providing address information.

The below defines the fields of the JSON structure used for all addresses. A subset of fields will be present in each case and address_format can be used to ascertain which ones for any given address. The country iso should not be used for this purpose.

Four address formats are available and detailed below:

Countries that use this formatGBR, JEY, IMNINDUSA, AUSAll other countries
address_format1234
udprnOptional
care_ofOptional
sub_buildingOptional*
building_numberOptional*
buildingOptional*Optional
streetOptional
landmarkOptional
address_line1MandatoryMandatoryMandatory
address_line2OptionalOptionalOptional
address_line3OptionalOptional
address_line4Optional
address_line5Optional
address_line6Optional
localityOptional
town_cityMandatoryOptionalMandatory
subdistrictOptional
districtOptional
stateOptionalOptionalMandatory
postal_codeMandatoryMandatoryMandatoryOptional
post_officeOptional
country_isoMandatoryMandatoryMandatoryMandatory
countryMandatoryMandatoryMandatoryMandatory
formatted_address**MandatoryMandatoryMandatoryMandatory

** At least one must be present

*** Will always be returned in the data extraction, but is not mandatory when configuring an applicant profile

Jump to..
Get a deeper dive on the user information, go to Understanding the report.
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard