Number Lookup API

REST API to find out statuses and network info of phone numbers


Setup

This tutorial will guide you through the setup of Number Lookup API.

  1. Create a Messente account
  2. Obtain your Messente API username and API password from API Settings page
  3. Start using the API

API request authentication

API endpoint

Number Lookup API requests are made to the following server:

https://api.messente.com

Authentication

Authentication is done using HTTP Basic Authentication using your Messente API username and password.

Request and response body

All request and response bodies for the API calls are JSON encoded strings according to the specification.

Response HTTP status codes

API call responses have status codes according to REST specifications.

Always set Accept and Content-Type headers to application/json as well.

Only 2XX response codes indicate a successful response.

Number Lookup Call

Request to lookup a number will be made to the following URL:

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

Request Headers

HTTP header Description Required
Content-Type application/json Yes
Accept application/json Yes

Example request

curl -X POST \
  https://api.messente.com/v1/hlr/sync \
  -u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD \
  -H 'Content-Type: application/json' \
  -d '{
  "numbers": [
      "+37251000000",
      "+37251000001"
    ]
  }'

Next Steps

Check out Number Lookup API reference