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>'
{
  "carrier": "AT&T",
  "country_code": "US",
  "line_type": "Mobile",
  "mcc": "310",
  "mnc": "410",
  "number_ported": true,
  "phone_number": "+1234567890"
}

Authorizations

x-api-key
string
headerrequired

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

Response

200 - application/json
carrier
string

The carrier of the phone number.

country_code
string

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

line_type
enum<string>

The type of phone line.

Available options:
FixedLine,
Mobile,
TollFree,
PremiumRate,
SharedCost,
Voip,
Pager,
VoiceMail,
UniversalAccess,
Service,
Unknown
mcc
string

The mobile country code of the phone number.

mnc
string

The mobile network code of the phone number.

number_ported
boolean

Whether the phone number has been ported.

phone_number
string

An E.164 formatted phone number.