CHOOSE A PARTNER
Select a suitable Channel Partner or aggregator that offers integration with the Open Gateway API to meet your needs. Contact an expert for more information on Channel Partner availability or to become a new Open Gateway partner.
The standardized Line Tenure API allows to know the actual age of a mobile line, helping to identify suspicious accounts and prevent identity fraud.
Fraudsters often use newly activated phone numbers to evade detection. The Line Tenure API identifies these "fresh" lines in real time, allowing institutions to block or review high-risk users in a timely manner.
The Line Tenure API helps companies identify fraud attempts by verifying the actual age of a mobile line.
It allows to reliably know how long a telephone number has been active with its current holder. This information, provided directly by the operator, serves as a key indicator to validate the legitimacy of the user, especially in risk assessment processes in financial transactions.
Line Tenure provides information on the type of contract associated with the line (prepaid, postpaid or corporate). This data allows a better understanding of the user's profile, as postpaid or corporate contracts tend to be associated with more established customers, while newly activated prepaid numbers may imply higher risk.
With the Line Tenure API, scoring models get more context on the age of the number, improving real-time risk analysis when combined with other indicators such as SIM or device changes.
The API allows financial service providers to define specific business rules (e.g., "dial mobile numbers less than 30 days old for manual review"). This facilitates a dynamic response to fraud and helps reduce false positives.
The standardized Line Tenure API with CAMARA eliminates technical and commercial complexity, facilitating access to multiple operators worldwide with a single implementation.
The API responds with a simple yes/no to defined permanence rules, without exposing personal data and facilitating secure and scalable identity checks. Complying with data protection frameworks.
Fraud prevention in the opening of accounts
Synthetic identity fraud, based on the creation of fictitious profiles combining real and false data, represents a growing threat to financial institutions. This type of fraud often relies on the use of newly activated phone numbers, making it difficult to detect using traditional methods. By integrating the Line Tenure API into the account creation flow, banks can identify new mobile lines associated with applicants and use this information as an indicator of risk. A line that is not very old is more likely to be linked to a fraud attempt. Thanks to this integration, it is possible to dynamically adapt risk controls, apply additional verification measures or even reject applications based on the defined tenure threshold. This allows organizations to reinforce security from the first point of contact with the user, without compromising the onboarding experience.
APIs used
Advanced account identification
"Mule" accounts are used by fraudsters to move illicit funds through peer-to-peer (P2P) networks. These accounts, often created or recruited to facilitate fraudulent activities, are often linked to newly activated phone numbers with little associated information. By incorporating the Tenure API into transaction monitoring systems, financial institutions can verify in real time the age of the recipients mobile number. If it is detected that the line has been assigned very recently, the transaction can be flagged as suspicious or temporarily held for analysis. This preventative capability helps stop the spread of fraud within the payment system, strengthening security without affecting the legitimate user experience.
APIs used
Risk assessment in high value transactions
Large transactions or those involving the addition of new beneficiaries require immediate risk analysis to prevent sophisticated fraud. By integrating the Tenure API into the process, banks can check the age of the senders phone number in real time. If the mobile line has been recently activated, the transaction can be flagged as high risk, which automatically triggers additional controls or targeted reviews. This validation brings an extra layer of security to sensitive transactions, without creating friction in the legitimate user experience.
APIs used
Secure account recovery
Account recovery is one of the most common vectors of fraud, especially when attackers impersonate legitimate users by impersonating or newly registering mobile numbers. With the Tenure API integration, enterprises can validate in real time whether the phone number associated with a recovery request has been active long enough to be considered trusted. If a newly activated line is detected, the process can be blocked, escalated or redirected to alternative verification methods. This strengthens security without compromising the experience of legitimate users attempting to regain access to their accounts.
APIs used
Test our APIs before anyone else, develop new use cases and create new experiences to harness the power of the network. Contact our experts if you need more information on how to transform your applications and services with our APIs.
Start integrating the Line Tenure API into your applications and access real-time network capabilities.
Follow these steps to access the Line Tenure API:
CHOOSE A PARTNER
Select a suitable Channel Partner or aggregator that offers integration with the Open Gateway API to meet your needs. Contact an expert for more information on Channel Partner availability or to become a new Open Gateway partner.
SIGN UP
In order to use Open Gateway products, you must register on the Partner platform.
ACCESSING Line Tenure
Once registered and with your credentials, you will be able to access the Line Tenure API on registered carriers by making API calls through your chosen Channel Partner's gateway.
REVIEWING PRIVACY POLICIES
Line Tenure requires the consent of the end user to access the payment authorisation on their behalf, so you will need to register with Telefónica through the Partner's platform.
Test our APIs before anyone else, develop new use cases and create new experiences to harness the power of the network. Contact our experts if you need more information on how to transform your applications and services with our APIs.
Start integrating the Line Tenure API into your apps and access network capabilities in real time.
As a developer, you will be able to consume this API either by using the HTTP protocol to perform requests to its standard Camara version on the API exposure platform of your provider of choice (availability will be indicated soon) or by integrating in your app the SDKs provided by those, which will make it simpler for you to authenticate, perform operations and handle results in the same programming language you are using.
If you want to preview and test how it will be like to use them, check the following developer resources:
Test our APIs before anyone else, develop new use cases and create new experiences to harness the power of the network. Contact our experts if you need more information on how to transform your applications and services with our APIs.
Log in to your private area to enjoy these contents.
Exclusive content
We offer a secure tool where you can test our Telco APIs, see how they work and validate your own use cases, through a UX interface common to any aggregator.
Don't have an account yet?
Join the Developer Hub or sign up for the Partner Program and enjoy all the exclusive Telefónica Open Gateway content for free.
Do you have any other questions? Contact our experts for any questions and advice.
The Line Tenure API allows service providers to check how long a mobile phone number has been associated with its current user. It returns a binary result confirming whether the line was active before a given reference date—providing a simple but powerful signal of identity stability.
In addition to tenure status, the API may also include the type of line—such as prepaid, postpaid, or enterprise—which adds context to the risk assessment. For example, a long-standing postpaid line typically indicates a higher trust level than a newly activated prepaid line.
A service (e.g., a bank) submits a phone number and a reference date. The Line Tenure API returns a binary response—true or false—depending on whether the mobile line was active before that date.
Primarily, the Line Tenure API provides a boolean value indicating if the number is older than a specified threshold. Optionally, it may include the type of contract (e.g., prepaid, postpaid, enterprise) if supported by the operator.
The Line Tenure API supports a wide range of fraud prevention and identity risk assessment scenarios, particularly where verifying thestability of a user's mobile identity is critical. Key use cases include:
Fraudsters often use recently activated phone numbers to evade detection. The Line Tenure API identifies these "fresh" lines in real time, enabling institutions to block or review high-risk users early.
Yes. By verifying that a user's mobile number has long-standing tenure, companies can approve low-risk users faster, reducing false fraud alerts and manual reviews.
No, the Line Tenure API is designed with privacy by design principles. It does not return PII (personally identifiable information), only anonymized tenure verification results.
Yes. It follows the CAMARA standard, supported by the GSMA and Linux Foundation, and is accessible through the Open Gateway initiative across multiple operators.
SIM Swap detects recent changes in the SIM card or IMSI, while Line Tenure focuses on the total age of the phone number assigned to the user. They are complementary signals for fraud detection.
While designed primarily for financial services, Line Tenure is also valuable in insurance, government services, e-commerce, and any domain wheremobile identity is part of user verification.
Yes. The Line Tenure API is designed to complement other network-based fraud signals such as SIM Swap, Number Verification, or Device Status.
Combining these APIs provides a more complete view of user trustworthiness,enabling stronger, layered fraud prevention strategies—especially in high-risk scenarios like on boarding, payment authentication, and account recovery.
The Line Tenure API allows clients to define a custom reference date against which the mobile line's age is evaluated. This means institutions can tailor the logic to their specific risk appetite—for example, flagging numbers newer than 7, 30, or 90 days depending on the sensitivity of the transaction or use case. This flexibility enables dynamic fraud strategies aligned with evolving threats and regulatory needs.
Access technical information, featured articles and other resources to learn more about the Line Tenure API and its benefits.
You have seen of documents
Load more