Check whether a user has been a customer of this operator continuously since a given date. Longer tenure usually suggests greater trustworthiness and can inform risk assessments.
The phone number was activated in 2021 and has remained with the operator from the specified start date through today.
The phone number was activated only 3 months ago. The response says “insufficient tenure”.
Business phone numbers can also be checked; the response identifies the contract type as Business.
A and BThe response only says whether the user has been a customer continuously since the specified start date. The activation date stays with the operator.
Contract typeThe response can include a contract type such as prepaid, monthly, or business.
Know Your Customer Tenure: How it works
- Specify start dateThe service provider sends the phone number and the start date tenureDate.
- Check tenureThe operator checks whether the phone number has remained active since that date.
- Return the resultReturns true or false, optionally with the contract type.
Know Your Customer Tenure: API spec
POST /check-tenuretenureDate (YYYY-MM-DD)| Response fields | Meaning | Example |
|---|---|---|
| tenureDateCheck | Whether the user has been a customer continuously since tenureDate | true |
| contractType | Contract type: PAYG (prepaid), PAYM (monthly), Business (business) | PAYM |
Responses for three scenarios (excerpts)
trueCustomer continuously since 2024-01-01PAYMMonthly contractfalseNot yet activated on 2025-10-13PAYGPrepaidtrueCustomer continuously since 2023-01-01BusinessBusinessSpec source: CAMARA Tenure r2.2 (KYC Tenure v0.2.0)