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.

Error List

We'll return the following error messages if something is wrong.

Error
Info
Field Type

{"ERR":"Could not authenticate"}

Invalid Key or Password.

String

{"ERR":"Unknown request type"}

Incorrect address. Usually means /hlr is missing or incorrect.

String

{"ERR":"MSISDN must be set"}

MSISDN= parameter missing from the request or MSISDN= contains an error.

String

{"ERR":"Too many requests"}

More than 80 numbers included in one request.

String

{"ERR":"Insufficient credits"}

Insufficient credit to perform lookup.

String

{"ERR":"Internal error"}

Database error.

String

{"ERR":"Request timed out"}

The reporting network took over 10 seconds to respond.

String

{"ERR":"Invalid API key"}

apikey= parameter missing from the request or apikey= contains an error.

String

{"ERR":"Invalid password"}

Password= parameter missing from the request.

String

Error List


We'll return the following error messages if something is wrong.

Suggested Edits are limited on API Reference Pages

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