GET
/
v2
/
lookup
/
{phone_number}
curl --request GET \
  --url https://api.prelude.dev/v2/lookup/{phone_number} \
  --header 'Authorization: Bearer <token>'
{
  "phone_number": "+33**********",
  "country_code": "FR",
  "network_info": {
    "carrier_name": "SFR",
    "mcc": "208",
    "mnc": "13"
  },
  "original_network_info": {
    "carrier_name": "Orange",
    "mcc": "208",
    "mnc": "13"
  },
  "flags": [
    "ported"
  ],
  "caller_name": "FINN",
  "line_type": "mobile"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
phone_number
string
required

An E.164 formatted phone number to look up.

Query Parameters

​
type
enum<string>[]

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
​
phone_number
string

The phone number.

Example:

"+33**********"

​
country_code
string

The country code of the phone number.

Example:

"FR"

​
network_info
object

The current carrier information.

​
original_network_info
object

The original carrier information.

​
flags
enum<string>[]

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
​
caller_name
string

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"

​
line_type
enum<string>

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"