GET
/
lookup
/
{phone_number}
curl --request GET \
  --url https://api.ding.live/v1/lookup/{phone_number} \
  --header 'customer-uuid: <customer-uuid>' \
  --header 'x-api-key: <api-key>'
{
  "phone_number": "+1234567890",
  "mcc": "310",
  "mnc": "410",
  "caller_name": "<string>",
  "carrier": "AT&T",
  "country_code": "US",
  "number_ported": true,
  "temporary_phone_number": true,
  "line_type": "Mobile"
}

The V1 API is deprecated. Technical support will end by October 2025 and will be removed by April 2026. No new features nor functionality will be added to the V1 API. Please use the V2 Lookup API instead.

Authorizations

​
x-api-key
string
header
required

Headers

​
customer-uuid
string
required

Your customer UUID, which can be found in the API settings in the dashboard.

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

An E.164 formatted phone number.

Example:

"+1234567890"

​
mcc
string

The mobile country code of the phone number.

Example:

"310"

​
mnc
string

The mobile network code of the phone number.

Example:

"410"

​
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.

​
carrier
string

The carrier of the phone number.

Example:

"AT&T"

​
country_code
string

The ISO 3166-1 alpha-2 country code of the phone number.

Example:

"US"

​
number_ported
boolean

Whether the phone number has been ported.

​
temporary_phone_number
boolean

Whether the phone number is in our database of disposable, temporary phone numbers

​
line_type
enum<string>

The type of phone line.

  • CallingCards - Numbers that are associated with providers of pre-paid domestic and international calling cards.
  • FixedLine - Landline phone numbers.
  • InternetServiceProvider - Numbers reserved for ISPs.
  • LocalRate - 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.
  • PremiumRate - Landline numbers where the calling party pays more than standard.
  • Satellite - Satellite phone numbers.
  • Service - Automated applications.
  • SharedCost - Specific landline ranges where the cost of making the call is shared between the calling and called party.
  • ShortCodesCommercial - Short codes are memorable, easy-to-use numbers, like the UK's NHS 111, often sold to businesses. Not available in all countries.
  • TollFree - Number where the called party pays for the cost of the call not the calling party.
  • UniversalAccess - 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.
  • VoiceMail - 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:
CallingCards,
FixedLine,
InternetServiceProvider,
LocalRate,
Mobile,
Other,
Pager,
PayPhone,
PremiumRate,
Satellite,
Service,
SharedCost,
ShortCodesCommercial,
TollFree,
UniversalAccess,
Unknown,
VPN,
VoiceMail,
Voip
Example:

"Mobile"