This method is only available as a headless check. It does not use the Age Verification Services UI.
If you have a verified email address for a user, you can ask us to check if the email address is likely to be associated with someone aged 18+ based on usage. We check email source, if it is linked to an employer and for any financial transactions tied it to, such as mortgages, credit cards, educational history or consumer behaviour. Yoti does not store the email address, require additional personal information or ask the user to perform any additional interactions.
Email address check requires provisioning through Yoti. Please get in touch through support.yoti.com if interested in using this solution.
This method is good for:
- Low friction
- Specific countries
If you wish to enable the Email Address service, please see below:
POST https://age.yoti.com/api/v2/non-interactive| Header | Description |
|---|---|
| Authorization | API Key to call the Yoti Age API. Should be sent as a 'Bearer {{API_TOKEN}}'. |
| Content-Type | application/json |
| Yoti-SDK-Id | Your unique Yoti-Sdk-Id (uuid) |
We recommend that you verify that the email is in the control of the target user, i.e. through OTP or registration.
Request body
All fields are mandatory.
{ "type": "OVER", "threshold": 18, "evidence": { "email": { "address": "<email address>" }, "country": "<country code>" }}| Field | Value | Description |
|---|---|---|
| type | OVER | Must be configured to 'OVER' as this is the only supported type. |
| threshold | 18 | Age threshold; must be configured to 18. |
| evidence | email, country | Verified email address of the user, and two letter ISO country code. |
Response
Below is an example response.
{ "evidence_id": "<UUID>", "method": "EMAIL", "created_at": "<timestamp>", "attempts": 1, "status": "COMPLETE", "result": true, "age": 18, "type": "OVER"}| Field | Description |
|---|---|
| evidence_id | Unique ID related to the request check being performed. |
| method | The Age Cerification method performed. |
| created_at | A timestamp for when the age verification method was attempted. |
| attempts | Attempt count for given method (for email age estimation through API, this is expected to be '1'). |
| status | COMPLETE - The email address has been associated with an Over 18 individual. ERROR - The check has been performed, but there are adversarial signals. FAIL - The email address has been associated with an Under 18 individual. INSUFFICIENT_DATA - Check performed; however, this is insufficient data to verify the user age. |
| result | Returns true if the threshold (18) has been met. Returns false if not met, or on error. |
| age | The threshold of the check (18). |
| type | Whether an OVER/UNDER or AGE type has been requested. Only OVER is supported for Email. |