Number Lookup

The Number Lookup endpoint enables you to retrieve MCC and MNC information for specific phone numbers. By using this method, you can query mobile number portability data to determine the current network operator for any MSISDN in international E.164 format.

A successful lookup (GET /number-lookup?msisdn={'{'}msisdn{'}'}) returns the queried number, a ported flag, mcc, mnc, and optionally the country, operator name, and numbertype (mobile, fix, wireless, voip, m2m, or satellite). Error responses use dedicated status codes for common cases such as an invalid or missing MSISDN (400), an invalid API key (401), insufficient account balance (402), a non-whitelisted IP address (403), and no portability information found for the MSISDN (404).