Data points returned by the
Session API, available for you to use in your application:
• Given names — Given names as stated on the passport or ID
• Surname — Surname as stated on the passport or ID
• Nationality — Two-letter ISO 3166 code (e.g. “US”)
• Sex — “MALE”, “FEMALE” or “UNSPECIFIED”
• Date of birth — Formatted as YYYY-MM-DD
• Personal number — If applicable, subject to country-specific formats
• Document type — The document type (e.g. “PASSPORT”)
• Document number — Document number as stated on the passport or ID
• Expiry date — Formatted as YYYY-MM-DD
• Issuing country — Two-letter ISO 3166 code (e.g. “US”)
• Issuer — Name of the issuing authority
• Portrait image — High resolution digital image from the passport or ID, base64 encoded PNG
• Face — Image of the user's face (if face verification was required), base64 encoded PNG
Certain data points are available in the SDK directly, without using the
Session API:
• Given names
• Surname
• Nationality
• Document type
• Document number
• Expiry date
• Issuing country
• Issuer
• Portrait image
These data points are unverified and unsecure, and should not be used for purposes other than providing a smooth user experience, such as greeting the user by their real name as they progress in the application flow.
Always use only the verified data from the
Session API for any real operations such as creating user accounts.