Open Gateway

All apis

Under CAMARA project
Spain
0.1.0
Brazil
0.1.0
United Kingdom
0.1.0

Line Tenure API

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.

What can it be used for?

The Line Tenure API helps companies identify fraud attempts by verifying the actual age of a mobile line.

Seniority verification

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.

Contract identification

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.

Risk analysis

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.

Flexibility in business logic

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.

Global coverage

The standardized Line Tenure API with CAMARA eliminates technical and commercial complexity, facilitating access to multiple operators worldwide with a single implementation.

Integrated privacy

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.

Use cases

Financial services & insurance

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

Fraud prevention in the opening of accounts
Financial services & insurance

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

Advanced account identification
Financial services & insurance

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

Risk assessment in high value transactions
ICT Services

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

Secure account recovery

Related APIs

Spain Germany Brazil United Kingdom

SIM Swap API

Allows to integrate SIM swap detection and management functionality based on data from the carrier's network. This facilitates the protocols and security measures of any service to be adjusted quickly and proportionately.

Financial services & insurance Social & customer engagement ICT Services Authentication and fraud prevention
Spain Germany Brazil

Number Verification API

Provides a mechanism to automatically verify whether a user is interacting via a device that has a SIM card associated with a certain phone number (MSISDN). This means that the user doesn´t have to enter any kind of credential or one-time password (OTP).

E-commerce & retail Financial services & insurance Media, entertainment & XR Authentication and fraud prevention
Spain Brazil

Device Swap API

It helps with the detection of unauthorised device swaps, making it easier to prevent potential fraud and protect users identities in real time.

Financial services & insurance Social & customer engagement ICT Services Authentication and fraud prevention
Spain Germany Brazil

Location Verification API

It verifies the geographical location of a given SIM-based device and validating whether it’s within a requested geographical area without spoofing or GPS theft. This allows to enable services or allow transactions in a safer way.

Data-driven marketing Financial services & insurance ICT Services Transport & logistics Location services
Spain

Carrier Billing API

Allows it easy to integrate mobile carrier payment into any application. This increases the security and speed of transactions.

Media, entertainment & XR Transport & logistics Payments and charging

Join our Developer Hub

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.

Under CAMARA project
Spain
0.1.0
Brazil
0.1.0
United Kingdom
0.1.0

Line Tenure API

Start integrating the Line Tenure API into your applications and access real-time network capabilities.

How to start

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.

Join our Developer Hub

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.

Under CAMARA project
Spain
0.1.0
Brazil
0.1.0
United Kingdom
0.1.0

Line Tenure API

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:

Join our Developer Hub

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.

Under CAMARA project
Spain
0.1.0
Brazil
0.1.0
United Kingdom
0.1.0

Line Tenure API

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.

Under CAMARA project
Spain
0.1.0
Brazil
0.1.0
United Kingdom
0.1.0

Line Tenure API

Do you have any other questions? Contact our experts for any questions and advice.

FAQs

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:

  • Fraud prevention during on boarding: Flagging accounts using recently activated phone numbers, often linked to synthetic identities or money mules.
  • Credit risk scoring: Using line tenure as a proxy for user stability and trustworthiness in loan or credit approval processes.

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.

Under CAMARA project
Spain
0.1.0
Brazil
0.1.0
United Kingdom
0.1.0

Line Tenure API

Access technical information, featured articles and other resources to learn more about the Line Tenure API and its benefits.

Subscribe to our Newsletter
Find out about the latest Telefónica Open Gateway product launches, events and news.
*Mandatory fields