Messente logo

Number Lookup API

All endpoints require HTTP basic authorization header with Messente API username and password.

You can find the API username and password under your Account API Settings.

Requests info about phone numbers

POST https://api.messente.com/v1/hlr/sync

Request Body

Body is required. Numbers for lookup
Property Type Info
numbersrequired array

Array of phone numbers

Element type: string

Successful Response

HTTP 200 - Info about phone numbers returned
Property Type Info
request_idrequired string

ID of the request

resultrequired array

A container for phone number info objects

Info about a phone number

Property Type Info
numberrequired string

Phone number in e.164 format

roaming boolean

Indicates if a number is roaming

ported boolean

Indicates if a number is ported

roamingNetwork object

Info about the network related to the phone number

Property Type Info
mccmnc string

Mobile country and mobile network code

networkName string

Mobile network name

countryName string

Country name

countryPrefix string

Country prefix

countryCode string

Country code

currentNetwork object

Info about the network related to the phone number

Property Type Info
mccmnc string

Mobile country and mobile network code

networkName string

Mobile network name

countryName string

Country name

countryPrefix string

Country prefix

countryCode string

Country code

originalNetwork object

Info about the network related to the phone number

Property Type Info
mccmnc string

Mobile country and mobile network code

networkName string

Mobile network name

countryName string

Country name

countryPrefix string

Country prefix

countryCode string

Country code

portedNetwork object

Info about the network related to the phone number

Property Type Info
mccmnc string

Mobile country and mobile network code

networkName string

Mobile network name

countryName string

Country name

countryPrefix string

Country prefix

countryCode string

Country code

status string

Status of the phone number

Possible values:
  • ON
  • OFF
  • INVALID
  • UNKNOWN
error

Indicates if any error occurred while handling the request

Error Responses

HTTP 400 - Invalid request
HTTP 401 - Unauthorized
HTTP 402 - Failed crediting
Property Type Info
errorsrequired array

An array of errors

A container for Number Lookup API error

Property Type Info
errorrequired object

Error fields container

Property Type Info
descriptionrequired string

Error description

coderequired integer

Matches the following error title. This field is a constant

  • 101 - Unauthorized
  • 102 - Invalid arguments or parameters
  • 103 - Server error
  • 104 - Crediting error #1
  • 105 - Crediting error #2
  • 106 - Client error
Maximum: 106
Minimum: 101