Phone Format Validation API

Check a number is properly formed. Instantly confirm a phone number is valid and correctly structured, and see its country and type, before it enters your system.

Try it free No card required

What it checks

Phone Format Validation confirms a number is well-formed and valid for its range, then normalises it into standard formats. It's the fast first gate on any phone field, catching malformed and out-of-range numbers the moment they're entered so only genuine numbers move further into your system.

What it returns

Format , the number in E.164, international and national formats
Country , the country the number belongs to
Assigned network , the network the number range is assigned to

When to use it

At point of capture on any form, to reject obviously invalid numbers instantly.
To weed out invalid numbers early, so your own downstream checks and outreach only run on numbers that could be real.
To normalise numbers into E.164 before storing them, keeping your data consistent.
In bulk, to clean malformed entries out of a list before any paid checks run.

When not to use it

As a reachability check, a well-formed number can still be switched off or disconnected. Use HLR for live reachability.
As a compliance check, format says nothing about TPS/CTPS registration; screen separately before marketing calls.
As an identity signal, it tells you the number is valid, not who holds it.
To assume the network is the current one, for a ported number, the assigned range network may differ from the live serving network (HLR returns that).

How to read the result

The result tells you whether a number is worth keeping and acting on. Well-formed numbers are safe to store and use; malformed ones can be rejected or sent back for correction at the point of entry.

Valid and well-formed: Normalise to E.164 and, if you need live reachability, send it on to an HLR lookup.
Invalid / wrong length: Reject at the form before spending on any paid check, and prompt the user to correct it.
Unexpected country: Useful as a quick sanity check against where you expect customers to be.

Pricing

Start Free

API & bulk usage

Run Phone Format Validation in real time on every phone field, or in bulk to check a whole list in one pass. Each number comes back with its validity and its E.164, international and national formats, plus the country and assigned network. Combine it with other checks in a single request when you want format plus reachability together.

Read the API reference →

Request

{
  "phone": {
    "phone": "447700900123",
    "route": "format"
  }
}

Response

{
  "phone": {
    "valid": true,
    "e164": "+447700900123",
    "country": "United Kingdom",
    "network": "Everything Everywhere EE"
  }
}

Common Questions

Phone Format Validation FAQ

Is phone format validation free?

Yes, it's free to start, so you can validate and normalise numbers from your first request, with no card required.

What's the difference between format validation and HLR?

Format validation checks the number is well-formed and assigned. HLR goes to the live network to confirm the handset is switched on and reachable. Run format first, then HLR on the numbers worth verifying.

Does it normalise numbers?

Yes. It returns standard E.164, international and national formats, which is handy for storing numbers consistently.

Will it tell me the current network for a ported number?

It returns the network the number range is assigned to. For a ported number, the live serving network can differ, the HLR check returns that.

Start with this check

Create a free account, claim your credits and run Phone Format Validation as a real-time API or a bulk upload. No card required.