Key concepts

This section lists some key concepts and terms used in the Assure API.

End-user

This is the person whose identity will be verified. Each end-user must have a dossier containing their personal information.

Dossier

Dossiers are resource objects that contain end-user identity data, e.g. name, date of birth, ID document, etc. Each end-user should have its own associated dossier. This means you must create a new dossier for each new end-user to perform an identity proofing on the user.

The end-user data may be put in the dossier both directly by adding files or data about the end-user or indirectly by creating processes in the dossier that will later contain identity data about the end-user.

A dossier can have more than one process inside and each process can use a different provider.

For more information, see the OpenAPI documentation > Dossiers.

Normalisation

All elements in responses you get from the Assure API are normalised, i.e., they will all follow the same format, depending on the type of data they represent.

Field	Format
Dates (e.g. dateOfBirth, dateOfExpiry, etc)	YYYY-MM-DD
createdAt, updatedAt	ISO 8601 (opens new window) UTC date: YYYY-MM-DDThh:mm:ssZ
issuingCountry, nationality	ISO 3166 Alpha 3 (opens new window) country codes. E.g. “PRT”, “NOR”.

Process

Processes are resource objects that contain end-user identity data. Like dossiers, they can also have associated files (e.g. ID images). However, additionally to dossiers, they have identity proofing result data obtained from the provider that was used to verify the information in the process.

You must create the process inside a dossier. Each process belongs to only one dossier, but a dossier may have multiple processes. You can only use one provider to verify the information on each process.

For more information, see the OpenAPI documentation > Processes.

Verification request

The action of requesting a provider to verify the information inside a process.

Verification result

This is information obtained from the provider with the outcome of checking the information inside a process.

This result is normalised by the Assure API and becomes part of the process too.