Number Lookup

There’s more
to a number
than digits.

Understand the number before your next call or message. Check its format and available metadata, or request live network information with HLR lookup.

Illustration of examining a number's format, network and status. Not a lookup result.#FormatNetworkStatus

Two checks.
Different answers.

Start with numbering information. Use live HLR when you need the network signals available for that destination.

Number metadata

Basic lookup

Normalize a phone number and understand its numbering-plan information.

  • International, national and E.164 formatting
  • Country and number type
  • Carrier details and time zones, when available
  • Numbering-plan validity
A valid format does not confirm an active subscriber.
Read the lookup reference
Live network information

HLR lookup

Request a live check for the operator and activity information the network can return.

  • Current and original network information
  • Portability information
  • Number status, where supported
  • Optional activity and ported-date checks
A billed lookup; available fields depend on network support.
Read the HLR reference

Better information.
More informed decisions.

Bring number information into your contact and communication workflows.

Consistent contact records

Normalize numbers into a common format and identify numbering-plan issues before using them in your systems.

More context for your application

Use available country, line-type and carrier information to inform your own application logic.

Additional network insight

Use HLR results to examine supported activity and portability signals without treating them as a delivery guarantee.

Optional HLR checks

Go deeper
where it’s supported.

Choose the extra information relevant to your number. Coverage and charges depend on the check and what the network returns.

Review current HLR options

Ported date

Request the date a number was ported when the operator supports it. An additional charge applies when the date is returned.

UK & Ireland fixed-line activity

Request an activity check for supported fixed-line numbers in the United Kingdom and Ireland.

US mobile activity

Request the deeper activity check available for supported United States mobile numbers.

For your application

Put the check
inside your workflow.

Use the API to request number metadata or live HLR information from your server. Each endpoint documents its parameters and response fields.

Explore the API
Basic lookup
GET/api/v1/lookup/number
Live HLR
POST/api/v1/lookup/hlr

HLR responses include cost_eur, the exact amount billed for that request.

Know what
the result tells you.

Numbering validity, live status and identity are different things. A lookup can provide useful number or network data; it does not establish who owns the number or guarantee that a call or SMS will reach them.

Explore SMS Messaging

Read the result
with confidence.

Ask our team
What is the difference between basic lookup and HLR?+

Basic lookup returns normalized numbering information, such as format, country and number type. Live HLR requests operator, portability and supported activity information from the network. HLR is a billed service.

Does a valid number mean someone is using it?+

No. The basic lookup’s valid_number_format field reflects numbering-plan validity. It does not confirm that a subscriber is currently active.

Will every lookup return all fields?+

No. Carrier details, activity signals, ported dates and other fields depend on the destination and available network information. Treat missing or unsupported data as unknown.

Can I identify the owner or their exact location?+

The documented lookup provides numbering and network information. It is not an owner-identity search or precise device-location service.

How are live HLR checks charged?+

Review the current rates in the portal documentation. Optional checks can change the billed amount for supported numbers, and each HLR response returns the exact charge in cost_eur.

Can I integrate lookup into my own software?+

Yes. Separate API endpoints are documented for basic number lookup and live HLR. Send requests from your server using the documented account authentication; review the response fields your workflow needs.

Start with
a clearer number.

Explore number metadata and live HLR options in your account.