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.

Response

200
application/json

OK

The response is of type object.

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.

Response

200
application/json

OK

The response is of type object.