---
title: "Look up for phone number"
method: GET
path: "/lookup/{phone_number}"
tags: ["Lookup"]
deprecated: true
---

# Look up for phone number

`GET /lookup/{phone_number}`

> **Deprecated.**

Perform a phone number lookup.

## Path parameters

- `phone_number` string, phone_number, required — An E.164 formatted phone number to look up.

## Query parameters

- `type` 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.

## Headers

- `customer-uuid` string, uuid, required — Your customer UUID, which can be found in the API settings in the dashboard.

## Response `200`

OK

- LookupResponse
  - `phone_number` string, phone_number — An E.164 formatted phone number.
  - `mcc` string — The mobile country code of the phone number.
  - `mnc` string — The mobile network code of the phone number.
  - `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.
  - `country_code` string — The ISO 3166-1 alpha-2 country code of the phone number.
  - `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` 'CallingCards' | 'FixedLine' | 'InternetServiceProvider' | 'LocalRate' | 'Mobile' | 'Other' | 'Pager' | 'PayPhone' | 'PremiumRate' | 'Satellite' | 'Service' | 'SharedCost' | 'ShortCodesCommercial' | 'TollFree' | 'UniversalAccess' | 'Unknown' | 'VPN' | 'VoiceMail' | 'Voip' — 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.

## Other responses

- `400` — Bad Request

## Changes

- **2025-04-28** `187cbbb71a45` — 1 info
  - endpoint deprecated
- **2024-12-10** `bdaf19490656` — 2 info
  - added the new optional `query` request parameter `type`
  - added the optional property `caller_name` to the response with the `200` status
- **2024-11-13** `20c44d44ac69` — 1 info
  - added the optional property `temporary_phone_number` to the response with the `200` status
- **2024-10-30** `1ec3fb120b7d` — 1 info
  - added the non-success response with the status `400`
- **2024-10-28** `ad06e2f6b7f4` — 1 info
  - removed the non-success response with the status `400`

[Full history](https://skmtc.dev/ding-live/apis/ding/changes/lookup/:phone_number/get.md)

---

[API](https://skmtc.dev/ding-live/apis/ding.md) · [All operations](https://skmtc.dev/ding-live/apis/ding/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ding-live/ding/revisions/060cbae07b8f/schema)