This method is only available as a headless check. It does not use the Age Verification Services UI.
Users provide their name, date of birth and address, and Yoti checks these details with a credit reference agency.
Age thresholds for these checks differ across countries and markets impacting the comparability of checks. 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.
We never store or share your details with anyone other than the provider.
The database check involves sending a POST request to our API with some of the user's personal information sent in the request body. This check will only confirm if the user is over/under 18; no threshold can be set.
This method is good for:
- Low friction
- Speed
If you wish to enable the Database service, please see below:
POST https://age.yoti.com/api/v1/address/backgroundThe 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
Below is an example response.
{ "status": "COMPLETE", "result": true, "age": 18, "method": "ADDRESS", "type": "OVER"}Error codes
| Error Code | Description |
|---|---|
| E300001 | Internal server error |
| E300003 | 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 |
| E300012 | Missing address field |
| E300013 | Invalid date of birth field |