Mobile type & tenure API

See the subscription behind the mobile number.

A mobile number alone does not tell you whether the subscription is Pay As You Go, Pay Monthly or Business.

Provero does.

Check the subscription type and whether the subscriber was connected to their current network on a date you choose. Use the result to segment records, qualify enquiries and add context to onboarding and risk checks.

Check new submissions through the API or upload an existing mobile list in bulk.

API and bulk upload
PAYG, Pay Monthly or Business
O2/Telefonica and Vodafone

Part of: KYC waterfall Account protection

Check mobile type and tenure View API docs Pricing on request. Email pricing@provero.io

Know which offer, workflow or check comes next

Stop treating every mobile record the same. Find out what subscription sits behind the number and put that information to work.

Find PAYG subscribers for Pay Monthly offers

If you sell mobile contracts, identify PAYG subscriptions in your data so you can target a relevant offer rather than send everyone the same campaign.
Separate Business and consumer subscriptions

Identify Business subscriptions and route them to the appropriate campaign or team. Keep PAYG, Pay Monthly and Business records separate without asking customers to classify themselves.
Check network history before making a decision

Was the subscriber already on their current network six months ago? Twelve months ago? Supply the date that matters to your process and get an answer you can use in onboarding or risk assessment.
Check new submissions or an existing file

Connect the API to your forms and workflows, or upload a file to check mobile records in bulk.

What it returns

Result	What it tells you
Contract type	PAYG (Pay As You Go), PAYM (Pay Monthly) or Business.
Network tenure	True or false: whether the subscriber was connected to their current network on the date checked.
Date checked	The date the tenure result applies to. If you do not send a date, today is used.
Current network code	The current network's Mobile Country Code and Mobile Network Code, returned as one value.

Coverage and access

Networks covered

Available for subscribers on O2/Telefonica and Vodafone. EE and Three are not currently covered.

Getting access

Create a Provero account and request Mobile type & tenure access from the Playground. Once enabled, use the service through the API or bulk upload.

Sample result

Example result

Result	Value
Subscription	Pay Monthly
On current network on 1 March 2026	Yes

Illustrative example, not a live check.

View API request and response

POST https://api.provero.io/api/validate/mobile-type-tenure

Request

{
  "mobile_number": "+447700900123",
  "tenure_date": "2026-03-01"
}

Sample response

{
  "status": "success",
  "verification_id": "mtn_123456",
  "mobile_number": "+447700900123",
  "tenure_date": "2026-03-01",
  "tenure_result": true,
  "contract_type": "PAYM",
  "mcc_mnc": "23415"
}

Illustrative example, not a live check. It shows a Pay Monthly subscriber who was connected to their current network on 1 March 2026.

View Mobile type & tenure API documentation

Pricing

Pricing on request

Mobile type & tenure is quoted on request, based on the volumes you expect. It runs on the same prepaid Provero balance as every other service.

Email pricing@provero.io.

Related checks

Each answers a different question about the same mobile number.

See every Provero check →

Mobile type & tenure FAQ

Can I check whether a mobile is PAYG or Pay Monthly?

Yes. Every successful check returns the contract type: PAYG for Pay As You Go, PAYM for Pay Monthly, or Business.

Does the service identify Business subscriptions?

Yes. Business is one of the three contract types returned, so you can separate business lines from consumer PAYG and Pay Monthly subscriptions.

What does the tenure result tell me?

Whether the subscriber was connected to their current network on the date you choose. Send the date that matters to your process, such as six months before an application, and the result comes back true or false for that date. If you leave the date out, today is used.

Does it return the exact network joining date?

No. It answers a yes or no question for the date you check: was the subscriber on their current network on that date? Choose the date that reflects the rule you want to apply.

Can I check mobile numbers in bulk?

Yes. Upload an existing mobile list through Provero, or connect the API to check records in your own systems.

Which networks are supported?

O2/Telefonica and Vodafone. EE and Three are not currently covered.

How is this different from HLR or SIM swap?

HLR phone verification tells you whether a number is live and which network serves it. A SIM swap check tells you whether the SIM changed recently. Mobile type & tenure tells you what kind of subscription sits behind the number and whether the subscriber was on their current network on a given date. Many teams use them together.

Put your mobile data to better use

Check new submissions through the API or process an existing mobile list in bulk. Create a Provero account and request access to get started.

Check mobile type and tenure