---
title: "Retrieve a Mobile Phone Number"
method: GET
path: "/v2/mobile_phone_numbers/{id}"
tags: ["Mobile Phone Numbers"]
---

# Retrieve a Mobile Phone Number

`GET /v2/mobile_phone_numbers/{id}`

## Path parameters

- `id` string, required

## Response `200`

Successful response

- object
  - `data` MobilePhoneNumber
    - `id` string — Identifies the resource.
    - `record_type` string — Identifies the type of the resource.
    - `phone_number` string — The +E.164-formatted phone number.
    - `sim_card_id` string, uuid — The ID of the SIM card associated with this number.
    - `status` string — The status of the phone number.
    - `connection_id` string, nullable — The ID of the connection associated with this number.
    - `connection_name` string, nullable — The name of the connection.
    - `connection_type` string, nullable — The type of the connection.
    - `mobile_voice_enabled` boolean — Indicates if mobile voice is enabled.
    - `tags` string[] — A list of tags associated with the number.
    - `customer_reference` string, nullable — A customer reference string.
    - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was last updated.
    - `call_forwarding` object
      - `call_forwarding_enabled` boolean
      - `forwards_to` string, nullable
      - `forwarding_type` 'always' | 'on-failure', nullable
    - `country_iso_alpha2` string — The ISO 3166-1 alpha-2 country code of the number.
    - `noise_suppression` 'inbound' | 'outbound' | 'both' | 'disabled' — The noise suppression setting.
    - `inbound_call_screening` 'disabled' | 'reject_calls' | 'flag_calls', nullable — The inbound call screening setting.
    - `caller_id_name_enabled` boolean — Indicates if caller ID name is enabled.
    - `call_recording` object
      - `inbound_call_recording_enabled` boolean
      - `inbound_call_recording_channels` 'single' | 'dual'
      - `inbound_call_recording_format` 'wav' | 'mp3'
    - `cnam_listing` object
      - `cnam_listing_enabled` boolean
      - `cnam_listing_details` string, nullable
    - `outbound` object
      - `interception_app_id` string, nullable — The ID of the app that will intercept outbound calls.
      - `interception_app_name` string, nullable — The name of the app that will intercept outbound calls.
    - `inbound` object
      - `interception_app_id` string, nullable — The ID of the app that will intercept inbound calls.
      - `interception_app_name` string, nullable — The name of the app that will intercept inbound calls.

## Other responses

- `404` — Resource not found

---

[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/versions/8f5f4e537994/schema)