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.