The service provider sets an age threshold. Using its registration records, the operator reports whether the phone number's user meets it. The birthdate stays with the operator.
The user is 30 and meets the age threshold of 18.
The user is 16. The response says “below threshold”.
Parental control and content lock settings can also be checked.
A and BThe response only says whether the user meets the threshold. The birthdate stays with the operator.
CYou can also choose to check content lock and parental control settings.
Know Your Customer Age Verification: How it works
- Set thresholdThe service provider sends the phone number and an age threshold (0–120 years).
- Check birthdateThe operator uses registration records to check whether the user meets the age threshold. Name, ID document number, and other details can also be included for comparison.
- Return the resultReturns "true", "false", or "not_available", optionally with verification status and a match score.
Know Your Customer Age Verification: API spec
POST /verifyageThreshold (0–120) and phone number; optionally name, ID document number, birthdate, and emailincludeContentLock, includeParentalControl| Response fields | Meaning | Example |
|---|---|---|
| ageCheck | Whether the user meets the age threshold | "true" |
| verifiedStatus | Whether details were checked against legally recognized age verification documents; some countries may allow alternatives such as credit checks | true |
| identityMatchScore | Overall identity match score (0–100) | 90 |
| contentLock | Whether the phone number has a content lock | "false" |
| parentalControl | Whether parental controls are enabled for the phone number | "true" |
Responses for three scenarios (excerpts)
"true"Age 18 or oldertrueDetails checked against age verification documents"false"Under age 18trueDetails checked against age verification documents"true"Age 18 or older"true"Parental controls are enabled for the phone number"false"No content lockSpec source: CAMARA KnowYourCustomerAgeVerification r1.3 (KYC Age Verification v0.2.1)
Know Your Customer Age Verification: GSMA use cases
Age Assurance
Problem to solveChecks that users meet age restrictions to protect minors and comply with regulations. The operator provides an age signal to help make the decision.
Know Your Customer Age Verification's roleProvides an age signal based on operator data without additional intrusive checks.
GSMA source ↗Sources: GSMA Open Gateway Use Case Library and API Descriptions (accessed 2026-10-14). Descriptions are summaries.