Email address check
If you already have a verified email address for a user, you can ask Yoti to check if it is likely to be associated with someone aged over 18.
Yoti checks the email source, if it is linked to an employer and for any financial transactions tied to it.
Email address check requires provisioning through Yoti. Please get in touch through support.yoti.com if interested in using this solution.
Endpoint
The API endpoint to request the email address check for age:
POST https://age.yoti.com/api/v2/non-interactiveHeaders
The HTTP headers for the API request:
| 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) |
Payload
You must verify that the email is in the control of the the target user, i.e. through OTP or registration.
The JSON structure for the API request (payload):
{ "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. |
Example Response
The JSON structure for the API 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 verification 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. |