post https://number-api.bind.hr/lookup/prefix
Introduction
Prefix resolving API's are allowing you to discover information about a provided number.
By using the prefix resolving API's you make sure that the number you are querying is valid, along with information related to the number itself, such as country and the network to which it belongs.
Example response
[
{
"country": {
"alpha2": "GB",
"code": "234",
"name": "United Kingdom",
"prefix": "44"
},
"date": "2023-02-19T10:04:18.934Z",
"msisdn": "447916123456",
"network": {
"code": "20",
"name": "MNO - Three UK",
"type": "Mobile"
},
"price": 0.0001,
"response": 0
}
]
Each response contains the following information:
date
- time when the request was executed (ISO8601)msisdn
- the number for which the response has been returnedcountry
name
- Country namecode
- Mobile country code (learn more)prefix
- Country calling prefixalpha2
- Alpha2 Country code (learn more)
network
name
- Network namecode
- Mobile network code (learn more)type
- Type of the number (Mobile
,Landline
)
price
- The price for this requestresponse
- The response indicating the success or failure (see below)
Response values
Value | Description | Action |
---|---|---|
0 | Success | ✈️ |
1 | General error | Repeating the request won't yield different result |
2 | Pricing not set | Contact [email protected] |
3 | Out of balance | Contact [email protected] |
4 | Throttled | Contact [email protected] |
5 | Invalid number | Number length not valid |
6 | Not resolved | Number cannot be resolved due to missing coverage |
7 | Timeout | Number cannot be resolved due to timeout |
8 | Missing permissions | Contact [email protected] |