Database

AI Tools

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:

Header

Description

Yoti-Sdk-Id

Your unique Sdk id

Authorization

Your API key (bearer token)

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

Error Code

Description

E300001

Internal server error

E300002

Bad request

E300003

Invalid country code

E300004

Not found

E300005

Unauthorised

E300006

Not allowed

E300007

Missing first name field

E300008

Missing last name field

E300009

Missing zip code field

E300010

Missing country field

E300011

Missing date of birth field