Carrier Lookup
To get more details about a number or to check if it is a valid number or not, you can use the Carrier Lookup command. To upload and check numbers in bulk – please use our Web app.
Check a single number
This API call allows you to retrieve additional information about a phone number: region-specific phone number formatting, carrier, phone type (landline/mobile) and country information.
To check a number, use:
GET /api/v2/lookups/{phone}?country={country}
with the following parameters:
| Name | Required? | Examples | Description |
|---|---|---|---|
| phone | Yes | 447860021130 |
Phone number in E.164 format or in National format. |
| country | No | GB |
This option must be specified only if the phone number in a National format. |
Numbers can be checked one by one. You cannot check multiple numbers in one request.
You will receive a response in the following format:
| Parameter | Example | Description |
|---|---|---|
| valid | true |
The field shows if entered phone number is valid or not. |
| number164 | +447860021130 |
Phone number in E.164 format. |
| local | 07860 021130 |
Phone number in National format. |
| country | Standard country object | Phone number country. |
| carrier | Telefonica UK |
Carrier name. |
| type | landline, mobile, or voip |
Phone number type. |
| cost | 0.04 |
Cost to check one number is constant – 0.04 in your account currency. |
