Know Your Customer Tenure

Know Your Customer Tenure

1.0.0OAS 3.0

CAMARA Know Your Customer (KYC) Tenure API.
Checks whether the tenure of a phone number is longer than
a provided threshold datetime.

API Base URL
  • Server 1:/
Security
OAuth2ClientCredentials (oauth2)

Client Credentials OAuth Flow

Token URL: https://auth.example.com/oauth2/token

Scopes:

  • tenure.read - Read phone number tenure signal

Know Your Customer Tenure

KYC tenure validation APIs

Check phone number tenure against a threshold

post
/tenure/v1/tenure

Headers

x-correlation-idstring

Correlation ID for request tracing

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

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

Body

{ "phoneNumber": "+919036499174", "thresholdDateTime": "2024-01-01T00:00:00Z" }
application/json

TenureRequest

object
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

Example

TenureResponse

object
tenureLongerThanThresholdbooleanrequired

Indicates whether the number tenure exceeds the threshold

Example:true

tenureStartDateTimestring(date-time)

Optional earliest known activation time

Example