Age Estimation
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
What is Age Estimation?
Age Estimation tells you if the person behind an email address, a phone number, or both, is an adult.
Send at least one of email or phone_number.
Response
| name | type |
|---|---|
| phone_is_valid_format | ?boolean Whether the phone_number sent can be parsed. Null when no phone_number was sent Ex: true |
| email_is_valid_format | ?boolean Whether the email sent can be parsed. Null when no email was sent Ex: true |
| match | ?boolean True when the person can be confirmed as an adult; False when the input data is valid but the person cannot be confirmed as an adult. Null otherwise Ex: true |
| is_adult | ?boolean True when the person is an adult. Null unless match is true Ex: true |
| date_of_birth | ?string date A date of birth when available Ex: 1992-06-27 |
Example
{
"phone_is_valid_format": true,
"email_is_valid_format": true,
"match": true,
"is_adult": true,
"date_of_birth": "1992-06-27"
}If the person cannot be confirmed as an adult, match is false and all other fields are null.
FAQ
Why do I need to pass a transaction_id?The
transaction_idrefers to one specific transaction in the system. The email or the phone number alone can collide when you send the same value twice. Thetransaction_idmust be unique across all the Trustfull API endpoints.
What is the supported phone_number format?Send the
phone_numberin international format: the country code, then the national number, without leading zeros. The endpoint also accepts a leading plus, spaces, dashes and brackets, and removes them before the lookup.
What is the supported email format?The
+tags are accepted. The endpoint does not remove spaces, so" [email protected]"is invalid. Accented letters and other non-ASCII characters are also invalid.
What happens if I pass an invalid phone number or email?We recommend that you validate the format before the request, or use our Phone Validation endpoint. If the
phone_numberor thephone_is_valid_formatoremail_is_valid_formatisfalse(or both), and all other fields arenull. The call costs the same as a standard API call.
What is the difference between match false and match null?
matchisfalsewhen the input is valid but the person cannot be confirmed as an adult.matchisnullwhen the email or the phone number has an invalid format. In both cases all fields arenull, and the call costs the same as a standard API call.
Can I send both an email and a phone number?Yes. The endpoint uses both of them to build one answer. Each field is optional, but you must send at least one of them.