Email

AI Tools

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.

Info

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

Endpoint

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)Authorization

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

{ "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.

Last updated on

Was this page helpful?