Get Started with Number Lookup – HTTP

Use the Number Lookup HTTP API to retrieve information about phone numbers. This page walks you through account sign up, what a request looks like, and Authentication.

Sign up for a Mitto Account

To get started with Mitto, do the following:

  1. Sign up for a Mitto account at https://www.mitto.ch/contact/ or write to info@mitto.ch.
  2. Submit the IPs you want to use for requests. They must be whitelisted on Mitto’s system.
  3. Mitto responds with your API key and confirmation that your IP addresses and callback URL are configured.

Request Requirements for the Number Lookup HTTP API

For the HTTP API, you can send requests using GET or POST and the response formatted as JSON or XML. The endpoint used is: https://api.mitto.ch/lookup.[FORMAT] where the FORMAT (used for the response) can be either JSON or XML.

Response Format and Content for the HTTP REST API

For the HTTP REST API, the response is returned in JSON data format by default, but the format can be JSON or XML. The response contains entries about the MSISDN you did lookups for. Here is a sample response:

[
{
“msisdn”: “491725551234”,
“mcc”: “262”,
“mnc”: “02”,
“ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49”
},
“cost”: 0.0017,
“date”: “2016-04-01T10:16:42Z”,
“response”: 0
}
]
[
{
“msisdn”: “491725551234”,
“mcc”: “262”,
“mnc”: “02”,
“ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49”
},
“cost”: 0.0017,
“date”: “2016-04-01T10:16:42Z”,
“response”: 0
}
]

Authentication

This section describes authentication for the HTTP REST API.

HTTP API Authentication

For the HTTP API, you must authenticate on each request. You do this by sending your API key in the URL call or Mitto’s custom header:

In the URL call
https://api.mitto.ch/lookup?key=YourAPIKey

In Mitto’s custom header
X-Mitto-API-Key: YourApiKey

For added security, each client calling the Number Lookup API must have a whitelisted IP address. Prior to accessing the service Mitto’s support team will contact you to add your IP addresses to our whitelist.