---
title: "Lookup phone number data"
method: GET
path: "/number_lookup/{phone_number}"
tags: ["Number Lookup"]
---

# Lookup phone number data

`GET /number_lookup/{phone_number}`

Returns information about the provided phone number.

## Path parameters

- `phone_number` string, required

## Query parameters

- `type` 'carrier' | 'caller-name'

## Response `200`

Successful response

- object
  - `data` NumberLookupRecord
    - `record_type` string — Identifies the type of record
    - `country_code` string — Region code that matches the specific country calling code
    - `national_format` string — Hyphen-separated national number, preceded by the national destination code (NDC), with a 0 prefix, if an NDC is found
    - `phone_number` string — E164-formatted phone number
    - `fraud` string, nullable — Unused
    - `carrier` Carrier
      - `mobile_country_code` string — Region code that matches the specific country calling code if the requested phone number type is mobile
      - `mobile_network_code` string — National destination code (NDC), with a 0 prefix, if an NDC is found and the requested phone number type is mobile
      - `name` string — SPID (Service Provider ID) name, if the requested phone number has been ported; otherwise, the name of carrier who owns the phone number block
      - `type` 'fixed line' | 'mobile' | 'voip' | 'fixed line or mobile' | 'toll free' | 'premium rate' | 'shared cost' | 'personal number' | 'pager' | 'uan' | 'voicemail' | 'unknown' — A phone number type that identifies the type of service associated with the requested phone number
      - `error_code` string, nullable — Unused
      - `normalized_carrier` string — If known to Telnyx and applicable, the primary network carrier.
    - `caller_name` CallerName
      - `caller_name` string — The name of the requested phone number's owner as per the CNAM database
      - `error_code` string — A caller-name lookup specific error code, expressed as a stringified 5-digit integer
    - `portability` Portability
      - `lrn` string — Local Routing Number, if assigned to the requested phone number
      - `ported_status` 'Y' | 'N' | '' — Indicates whether or not the requested phone number has been ported
      - `ported_date` string — ISO-formatted date when the requested phone number has been ported
      - `ocn` string — Operating Company Name (OCN) as per the Local Exchange Routing Guide (LERG) database
      - `line_type` string — Type of number
      - `spid` string — SPID (Service Provider ID)
      - `spid_carrier_name` string — Service provider name
      - `spid_carrier_type` string — Service provider type
      - `altspid` string — Alternative SPID (Service Provider ID). Often used when a carrier is using a number from another carrier
      - `altspid_carrier_name` string — Alternative service provider name
      - `altspid_carrier_type` string — Alternative service provider type
      - `city` string — City name extracted from the locality in the Local Exchange Routing Guide (LERG) database
      - `state` string

## Other responses

- `422` — Unprocessable entity. Check the 'detail' field in response for details.
- `default` — Unexpected error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)