x-correlation-idstring
Correlation ID for request tracing
Know Your Customer Tenure
KYC tenure validation APIs
Check phone number tenure against a threshold
post
/tenure/v1/tenure
Headers
Body
application/json
Body
application/json
TenureRequest
phoneNumberstringrequired
MSISDN in E.164 format
Example:+919036499174
thresholdDateTimestring(date-time)required
The API checks whether the phone number tenure
is longer than this datetime.
Example:2024-01-01T00:00:00Z
Response
application/json
Response
application/json
Tenure check result
TenureResponse
tenureLongerThanThresholdbooleanrequired
Indicates whether the number tenure exceeds the threshold
Example:true
tenureStartDateTimestring | null(date-time)
Optional earliest known activation time
post/tenure/v1/tenure
Authentication
Headers
Body
{
"phoneNumber": "+919036499174",
"thresholdDateTime": "2024-01-01T00:00:00Z"
}
application/json
TenureRequest
objectphoneNumberstringrequired
MSISDN in E.164 format
Example:+919036499174
thresholdDateTimestring(date-time)required
The API checks whether the phone number tenure
is longer than this datetime.
Example:2024-01-01T00:00:00Z
Example
TenureResponse
objecttenureLongerThanThresholdbooleanrequired
Indicates whether the number tenure exceeds the threshold
Example:true
tenureStartDateTimestring(date-time)
Optional earliest known activation time
Example
Error
objectstatusintegerrequired
Example:400
codestringrequired
Example:INVALID_ARGUMENT
messagestringrequired
Example:Invalid request
Example