Validates a single phone number

🚧

This service is chargeable per call

This service is chargeable per call and therefore requires Pay As You Go (PAYG) setup on your account prior to calling. Please see this article to find out more about setting up PAYG

The Validate Single Number method allows you to check the validity of a phone number and whether the handset is currently on or off. You can also discover details about the network the phone number is on and whether the phone is outside its native country.

It makes a HLR request to the mobile networks to discover information about the phone number and its current status. HLR is widely supported globally but the amount of information returned can vary by country and network. Please see our HLR coverage table here for more details about coverage in specific countries.

The status returned will be one of the following:

Status

Description

On

The number exists and the handset is currently switched on.

Off

The number exists, but the handset is currently switched off or out of range.

Dead

The number does not exist.

NotProvisioned

The number exists, but is not owned by a mobile network, for example a landline number.

BadNumber

The number does not conform to a recognised pattern or contains non numeric characters.

CountryMismatch

The number is not in a format that matches the requested country code.

ImpersonationFailed

A username supplied to ValidateNumberForUserNames is not recognised.

Language
Authentication
Basic
base64
:
URL
Click Try It! to start a request and see the response here!