Home / Docs / KYC Match

Know Your Customer Tenure

The Know Your Customer (KYC) Tenure functionality allows you to verify that a network subscriber has maintained continuous customer status with the Communications Service Provider, confirming that the length of the tenure, bound to the user's network subscription identifier, exceeds a specified threshold. This is a simple and efficient method offering a strong indicator of user stability and trustworthiness, reducing reliance on self-reported identity data.

Performing a tenure checkheader link

To perform a tenure check, you must provide the network subscription identifier (e.g. the mobile phone number for a mobile network subscriber) and the specified minimum tenure date to validate for the associated network subscription:

import network_as_code as nac
from datetime import (
    datetime,
    timedelta,
    timezone,
    date
)

# Initialize the client object with your application key
client = nac.NetworkAsCodeClient(
   token="<your-application-key-here>"
)

# Add the tenure date from which the continuous tenure of the subscriber is to be confirmed
# For example, to verify a year long tenure:

result = client.kyc.check_tenure(
    phone_number="+99999991000",
    # You can also use `date(YYYY, MM, DD)` or a string value in 'YYYY-MM-DD' format
    tenure_date=datetime.now(timezone.utc) - timedelta(days=365)
)

# If successful, you can access the results like so:
print(result)

Following parameters have to be supplied to the check tenure request:

Property	Description	Mandatory or Optional
`phone_number`	A globally unique telephone number in E.164 format (prefixed with '+'), example: "+99999991000".	Mandatory
`tenure_date`	Datetime, date or string value, from which the tenure of the identified network subscriber is required to be confirmed in RFC 3339 / ISO 8601 format (YYYY-MM-DD).	Mandatory

The response will be an object containing the following fields:

Property name	Description
`tenure_date_check`	Boolean value, indicating if the identified network subscription has had valid tenure since `tenure_date`.
`contract_type`	If present, specifies the network subscription account type. Possible values `PAYG`, `PAYM` and `Business`. If absent, the account type is not known.

Last updated December 19, 2025