HLR Lookup Documentation

The HLR Lookup Developer Hub

Welcome to the HLR Lookup help pages. Here you'll find all the information you need to get started with our API or batch upload services.
Search the docs for explanations on the results you'll receive and a breakdown of all the possible parameters available.

Types available

A description of all number types we could return.

Response Description


A phone number for a phone that uses radio waves for transmissions. Also known as Cell Phone.


Refers to a number for a phone that uses wires from a fixed location such as in the home or office

Landline or Mobile

Applicable when performing a Global Dialplan Validator check on numbers allocated to the North American Numbering Plan (Prefix 1). For more detailed information a full HLR Lookup is required.


Numbers allocated to a device that receives and displays numeric and/or receives and announces voice messages.


Voice Over Internet Protocol - This allows the delivery of phone calls over the internet.

Toll Free

Also known as Freephone. This indicates that this number can be called at no cost.

Personal Number

This number type relates to a virtual telephone number which allows the user to route calls to this number to any other number anywhere in the world.

Shared Cost

Numbers that are billed to both the caller and the business that utilises them.

Premium Rate

These numbers cost a higher than normal price to call. They are often linked to organisations where services are provided by making the call. This allows the business providing the numbers to be funded via the calls it receives.


Number that allows the caller to contact the local emergency services.


Numbers linked exclusively to a voicemail account.

Short Code

Numbers designed to be easier to read and remember than normal telephone numbers and are widely used for value-added services.


An invalid phone number that does not fit into any of the above categories.

Types available

A description of all number types we could return.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.