This method is available through the:
- Age Verification UI
- or as a headless check.
If the check is conducted via the UI, the user shares their phone number, and a one-time passcode (OTP) is sent to them by SMS. The user enters the OTP code, and it is verified. If the check is carried out via the API, you can input the OTP yourself. With either flow, the name and date of birth associated with the phone number are checked by third-party providers.
Using telco and non-authoritative data, Yoti can retrieve the identity of a person linked to a mobile phone number. This is often sufficient to determine the exact age of the person or if they are an adult.
Providers verify possession of a mobile device, not the ownership. It is unknown if the phone may be in the permanent or temporary possession of someone who is not the owner.
This method is good for:
- Low friction
- Specific countries
We never store or share the user’s details with anyone other than the provider.
Request body
If you wish to enable the Mobile phone service, please see below:
{ "type": "OVER", "mobile": { "allowed": true }, "ttl": 900, "reference_id": "over_18_example", "callback": { "auto": true, "url": "https://www.yoti.com" }, "notification_url": "https://yourdomain.example/webhook", "cancel_url": "https://www.yoti.com"}| Parameter | Types | Description |
|---|---|---|
| allowed | true / false | Enable the verification method to be available for the user to use. |
This is the end of integrating this method. If you decide to integrate the service as a headless check please see the below section.
Example response
Below is an example response.
{ "method": "MOBILE", "type": "OVER", "threshold": 18, "age": 18, "result": true, "status": "COMPLETE", "evidence_id": "ef4846dd-10fa-4c1b-ba81-f9046c698c8a"}| Field | Description |
|---|---|
| method | The AV method used. MOBILE is returned for mobile checks |
| type | Dictates the threshold type. For mobile checks only OVER is returned |
| threshold | The age threshold that has been met |
| age | The age threshold that has been met |
| result | Returns true if the threshold (18) has been met. Returns false if not met, or on error |
| status | COMPLETE - The phone number has been associated with an Over 18 individual ERROR - We could not provide an age result, because we didn't have enough info associated with that phone number FAIL - The phone number has been associated with an Under 18 individual |
| evidence_id | The Evidence ID can be re-shared with Yoti to provide evidence that a check of a mobile phone number was performed. The mobile phone number or associated personal information is not stored by Yoti, this can never be retrieved. Yoti will be able to confirm that a check took place at a specific time, the processing steps and result of the check |