Sinch Developer Documentation

We provide building blocks to enable you to build rich customer communication

Get Started

HTTP Interface

How To Connect

Please find the hosts and port numbers for our Number Lookup HTTP/HTTPS server in the table below. Your username and password is available in the CAD (Client Account Details) document provided to you by your account manager.

For servers in Europe

Server Host:Port
Primary Number Lookup HTTP Server
Backup Number Lookup HTTP Server
Primary Number Lookup HTTPS Server
Backup Number Lookup HTTPS Server

For servers in the U.S.

Server Host:Port
Primary Number Lookup HTTP Server
Backup Number Lookup HTTP Server
Primary Number Lookup HTTPS Server
Backup Number Lookup HTTPS Server

Query Specification


The request has the format:


Parameter Description
\<username\>:\<password\> Basic authentication parameters
\<server\> Authority []
\<port\> Port number [3700]
\<msisdn\> MSISDN in international format
nocache Bypass cache function (optional)


One of the responses when using Number Portability Lookup service:

Example 1


Example 2


Response when using the Real-Time Lookup service:

Parameter Description
\<result\> Lookup result (Response Code)
\<imsi\> MCC+MNC corresponding to the MSISDN (only included when result is OK)
\<location\> Country Code of current handset location (only included when result is OK)

Response Codes

Result Description
OK The request was successful
DATA_MISSING The data was missing
UNKNOWN_SUBSCRIBER The subscriber is unknown
CALL_BARRED The service is restricted by the destination network
ABSENT_SUBSCRIBER_SM The subscriber is absent
UNEXPECTED_DATA_VALUE An unexpected data value in the request
SYSTEM_FAILURE A system failure occurred in the HLR
FACILITY_NOT_SUPPORTED Short message facility is not supported
TELE_SERVICE_NOT_PROVISIONED SMS teleservice is not provisioned
HLR_REJECT The HLR request was rejected
HLR_ABORT The HLR (or some other entity) aborted the request. No response to the request was received
HLR_LOCAL_CANCEL No response for the HLR request was received
TIMEOUT No response to the request was received
REQUEST_THROTTLED Maximum ongoing requests exceeded
IMSI_LOOKUP_BLOCKED Request is blocked
Mandatory parameter msisdn not found Some mandatory parameter are missing in the request
MSISDN range is not accepted The number are not allowed on this service
msisdn is invalid Wrong format of the MSISDN parameter


HTTP Request



HTTP Request with cache function bypass

Successful response, Number Portability Lookup

Successful response




Unsuccessful response

Unsuccessful response


Request with successful response, using curl

$ curl -v -u user:password
* About to connect() to port 3700 (#0)
* Trying…
* Connected to ( port 3700 (#0)
* Server auth using Basic with user ‘user’
> GET /lookup?msisdn=46708100200 HTTP/1.1
> Authorization: Basic dXNlcjpwYXNzd29yZA==
> User-Agent: curl/7.30.0
> Host:
> Accept: */*
< HTTP/1.1 200 OK, Success
< Date: Mon, 12 Feb 2014 11:00:41 +0100
< Content-Length: 20
< Content-Type: text/plain; charset=ISO-8859-1
* Connection #0 to host left intact


Edit on GitHub

HTTP Interface

Suggested Edits are limited on API Reference Pages

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