> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mobile Phone Numbers

> Assign real phone numbers to SIMs for voice calling and messaging.

When you enable voice on a SIM, Telnyx assigns a Mobile Phone Number — a real +E.164 number. Inbound calls ring the device natively. Outbound calls show your number as caller ID.

## Enabling Voice

Voice is enabled per-SIM via action endpoints, not by patching a field.

| Action                                                                                   | Endpoint                                     |
| :--------------------------------------------------------------------------------------- | :------------------------------------------- |
| [Enable Voice](/api-reference/sim-cards/request-a-sim-card-enable)                       | `POST /sim_cards/{id}/actions/enable_voice`  |
| [Disable Voice](/api-reference/sim-cards/request-a-sim-card-disable)                     | `POST /sim_cards/{id}/actions/disable_voice` |
| [Bulk Enable Voice](/api-reference/sim-cards/request-bulk-enabling-voice-on-sim-cards)   | `POST /sim_cards/actions/bulk_enable_voice`  |
| [Bulk Disable Voice](/api-reference/sim-cards/request-bulk-disabling-voice-on-sim-cards) | `POST /sim_cards/actions/bulk_disable_voice` |

`enable_voice` accepts an optional `connection_id` to associate with a Mobile Voice Connection.

## Mobile Phone Number

Once voice is enabled, manage the assigned number via:

| Action                                                                            | Endpoint                           |
| :-------------------------------------------------------------------------------- | :--------------------------------- |
| [List Numbers](/api-reference/mobile-phone-numbers/list-mobile-phone-numbers)     | `GET /mobile_phone_numbers`        |
| [Get Number](/api-reference/mobile-phone-numbers/retrieve-a-mobile-phone-number)  | `GET /mobile_phone_numbers/{id}`   |
| [Update Number](/api-reference/mobile-phone-numbers/update-a-mobile-phone-number) | `PATCH /mobile_phone_numbers/{id}` |

### Configurable Settings

| Setting                  | Description                                        |
| :----------------------- | :------------------------------------------------- |
| `call_forwarding`        | Forward calls on no-answer, busy, or unconditional |
| `call_recording`         | Record inbound, outbound, or both                  |
| `caller_id_name_enabled` | Enable CNAM lookup on outbound calls               |
| `cnam_listing`           | Register business name for inbound CNAM display    |
| `noise_suppression`      | AI noise reduction on calls                        |
| `inbound_call_screening` | Filter inbound calls before connecting             |
| `connection_id`          | Associate with a Mobile Voice Connection           |
| `customer_reference`     | Your own reference string                          |
| `tags`                   | Arbitrary tags for filtering                       |
| `inbound` / `outbound`   | Routing configuration per direction                |

## Mobile Voice Connection

The voice application attached to a number — controls webhooks, API version, and routing.

| Action                                                                                    | Endpoint                                |
| :---------------------------------------------------------------------------------------- | :-------------------------------------- |
| [List Connections](/api-reference/mobile-phone-numbers/list-mobile-voice-connections)     | `GET /mobile_voice_connections`         |
| [Create Connection](/api-reference/mobile-phone-numbers/create-a-mobile-voice-connection) | `POST /mobile_voice_connections`        |
| [Get Connection](/api-reference/mobile-phone-numbers/retrieve-a-mobile-voice-connection)  | `GET /mobile_voice_connections/{id}`    |
| [Update Connection](/api-reference/mobile-phone-numbers/update-a-mobile-voice-connection) | `PATCH /mobile_voice_connections/{id}`  |
| [Delete Connection](/api-reference/mobile-phone-numbers/delete-a-mobile-voice-connection) | `DELETE /mobile_voice_connections/{id}` |

### Connection Settings

| Setting                      | Description                           |
| :--------------------------- | :------------------------------------ |
| `webhook_event_url`          | Where call events are sent            |
| `webhook_event_failover_url` | Backup URL if primary fails           |
| `webhook_timeout_secs`       | How long to wait for webhook response |
| `outbound` / `inbound`       | Routing configuration per direction   |
| `active`                     | Whether the connection is active      |