With our APIs you can easily integrate with your application or workflow. You can use our Prefix Check, MNP Lookup or HLR Lookup API. Each API endpoint work in the same way and is really easily to integrate.
Authorization
On each API request you need to provide your API token in the “Authorization: Bearer YOUR_API_TOKEN” HTTP header.
API call: HLR lookup
To perform a hlr lookup for a single mobile number, you need to make a POST request to the following URL: POST https://app.mobile-lookup.com/api/hlr-lookups/single
The mobile number you want to check needs to be passed as the POST parameter “mobile_number”. The response will be in JSON format.
cURL example request:
curl --location 'https://app.mobile-lookup.com/api/hlr-lookups/single' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data-urlencode 'mobile_number=491761234567'
Example success response:
{ "success": true, "data": { "msisdn": "491761234567", "absent": false, "ported": false, "roaming": false, "gsmCode": 0, "gsmCodeDescription": "No error", "mcc": "262", "mnc": "07", "originalNetwork": { "countryName": "Germany", "countryPrefix": "49", "networkName": "O2" } }, "message": "Hlr lookup successfully performed" }
API call: MNP lookup
To perform a mnp lookup for a single mobile number, you need to make a POST request to the following URL: POST https://app.mobile-lookup.com/api/mnp-lookups/single
The mobile number you want to check needs to be passed as the POST parameter “mobile_number”. The response will be in JSON format.
cURL example request:
curl --location 'https://app.mobile-lookup.com/api/mnp-lookups/single' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data-urlencode 'mobile_number=491761234567'
Example success response:
{ "success":true, "data": { "msisdn": "491761234567", "ported":false, "mcc":"262", "mnc":"07", "originalNetwork": { "countryName": "Germany", "countryPrefix": "49", "networkName": "O2"}}, "message":"Mnp lookup successfully performed" }
API call: Prefix check
To perform a mnp lookup for a single mobile number, you need to make a POST request to the following URL: POST https://app.mobile-lookup.com/api/prefix-checks/single
The mobile number you want to check needs to be passed as the POST parameter “mobile_number”. The response will be in JSON format.
cURL example request:
curl --location 'https://app.mobile-lookup.com/api/prefix-checks/single' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data-urlencode 'mobile_number=491761234567'
Example success response:
{ "success": true, "data": { "msisdn": 491761234567, "prefix": "49178", "mcc": 262, "mnc": "07", "countryIsoAlpha2": "de", "networkNameShort": "O2", "networkNameFull": "Telef\u00f3nica Germany GmbH Co. OHG (former: E-Plus Mobilfunk GmbH)", "countryCode": "49", "ndc": "178"}, "message":"Prefix check successfully performed" }