Database

Overview

Here you can verify your users name, date of birth and address against a credit reference agency database.

In some countries, users will be on a database if they have signed a credit agreement. This may exclude those in lower income groups or younger adults and students.

Good for:

• Background checks
• Specific countries

The user will be asked to prove their age using your name, date of birth and address.

Yoti will send these details to a credit reference agency provider to confirm they are accurate and obtain or confirm your date of birth.

You can receive:

• If you are ‘over’ or ‘under’ their age requirement

We never store or share your details with anyone other than the provider.

If you wish to enable the database check service as an option to perform an age verification service. The database check involves sending a POST request to our API with some of the users personal information sent in the request body. This information is compared to a CRA provider to determine if the user is over 18. (important) this check will only confirm if the user is over/under 18 no threshold can be set.

Endpoint

POST https://age.yoti.com/api/v1/address/background

Request Headers

The following elements are needed in the header:

Request Body

All fields are mandatory.

{

   "first_name": "John",

   "last_name": "Doe",

   "country": "GB",

   "address_lines": [

      "address_line1",

      "address_line2",

      "address_line3"

   ],

   "postal_code": "postcode",

   "date_of_birth": "mm-dd-yyyy"

}

Response

{

   "status": "COMPLETE",

   "result": true,

   "age": 18,

   "method": "ADDRESS",

   "type": "OVER"

}

Error Code