Lookup a phone number
Retrieve detailed information about a phone number including carrier data, line type, and portability status.
GET
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
An E.164 formatted phone number to look up.
Query Parameters
Optional features. Possible values are:
cnam
- Retrieve CNAM (Caller ID Name) along with other information. Contact us if you need to use this functionality.
Available options:
cnam
Response
200
application/json
OK
The phone number.
Example:
"+33**********"
The country code of the phone number.
Example:
"FR"
The current carrier information.
The original carrier information.
A list of flags associated with the phone number.
ported
- Indicates the phone number has been transferred from one carrier to another.temporary
- Indicates the phone number is likely a temporary or virtual number, often used for verification services or burner phones.
Available options:
ported
, temporary
The CNAM (Caller ID Name) associated with the phone number. Contact us if you need to use this functionality. Once enabled, put cnam
option to type
query parameter.
Example:
"FINN"
The type of phone line.
calling_cards
- Numbers that are associated with providers of pre-paid domestic and international calling cards.fixed_line
- Landline phone numbers.isp
- Numbers reserved for Internet Service Providers.local_rate
- Numbers that can be assigned non-geographically.mobile
- Mobile phone numbers.other
- Other types of services.pager
- Number ranges specifically allocated to paging devices.payphone
- Allocated numbers for payphone kiosks in some countries.premium_rate
- Landline numbers where the calling party pays more than standard.satellite
- Satellite phone numbers.service
- Automated applications.shared_cost
- Specific landline ranges where the cost of making the call is shared between the calling and called party.short_codes_commercial
- Short codes are memorable, easy-to-use numbers, like the UK's NHS 111, often sold to businesses. Not available in all countries.toll_free
- Number where the called party pays for the cost of the call not the calling party.universal_access
- Number ranges reserved for Universal Access initiatives.unknown
- Unknown phone number type.vpn
- Numbers are used exclusively within a private telecommunications network, connecting the operator's terminals internally and not accessible via the public telephone network.voice_mail
- A specific category of Interactive Voice Response (IVR) services.voip
- Specific ranges for providers of VoIP services to allow incoming calls from the regular telephony network.
Available options:
calling_cards
, fixed_line
, isp
, local_rate
, mobile
, other
, pager
, payphone
, premium_rate
, satellite
, service
, shared_cost
, short_codes_commercial
, toll_free
, universal_access
, unknown
, vpn
, voice_mail
, voip
Example:
"mobile"