---
title: "Delete a phone number"
method: DELETE
path: "/phone_numbers/{id}"
tags: ["Phone Number Configurations"]
---

# Delete a phone number

`DELETE /phone_numbers/{id}`

Deletes the specified phone number from the account. The response contains the phone number's final deleted representation.

## Path parameters

- `id` string, required

## Response `200`

Successful response with details about a phone number.

- object
  - `data` NumbersPhoneNumberDeletedDetailed
    - `activated_at` string, date-time, nullable — ISO 8601 formatted date indicating when the phone number was first activated (transitioned from purchase-pending or port-pending to active). Will be null for numbers that have not yet been activated, or for legacy numbers activated before this field was tracked.
    - `billing_group_id` string — Identifies the billing group associated with the phone number.
    - `call_forwarding_enabled` boolean — Indicates if call forwarding will be enabled for this number if forwards_to and forwarding_type are filled in. Defaults to true for backwards compatibility with APIV1 use of numbers endpoints.
    - `call_recording_enabled` boolean — Indicates whether call recording is enabled for this number.
    - `caller_id_name_enabled` boolean — Indicates whether caller ID is enabled for this number.
    - `cnam_listing_enabled` boolean — Indicates whether a CNAM listing is enabled for this number.
    - `connection_id` string — Identifies the connection associated with the phone number.
    - `connection_name` string — The user-assigned name of the connection to be associated with this phone number.
    - `created_at` string — ISO 8601 formatted date indicating when the time it took to activate after the purchase.
    - `customer_reference` string — A customer reference string for customer look ups.
    - `deletion_lock_enabled` boolean — Indicates whether deletion lock is enabled for this number. When enabled, this prevents the phone number from being deleted via the API or Telnyx portal.
    - `emergency_address_id` string — Identifies the emergency address associated with the phone number.
    - `emergency_enabled` boolean — Indicates whether emergency services are enabled for this number.
    - `external_pin` string — If someone attempts to port your phone number away from Telnyx and your phone number has an external PIN set, Telnyx will attempt to verify that you provided the correct external PIN to the winning carrier. Note that not all carriers cooperate with this security mechanism.
    - `hd_voice_enabled` boolean — Indicates whether HD voice is enabled for this number.
    - `id` string — Identifies the resource.
    - `messaging_profile_id` string — Identifies the messaging profile associated with the phone number.
    - `messaging_profile_name` string — The name of the messaging profile associated with the phone number.
    - `phone_number` string — The +E.164-formatted phone number associated with this record.
    - `phone_number_type` 'local' | 'toll_free' | 'mobile' | 'national' | 'shared_cost' | 'landline' — The phone number's type.
    - `purchased_at` string — ISO 8601 formatted date indicating the time the request was made to purchase the number.
    - `record_type` string — Identifies the type of the resource.
    - `status` 'purchase-pending' | 'purchase-failed' | 'port-pending' | 'port-failed' | 'active' | 'deleted' | 'emergency-only' | 'ported-out' | 'port-out-pending' — The phone number's current status.
    - `t38_fax_gateway_enabled` boolean — Indicates whether T38 Fax Gateway for inbound calls to this number.
    - `tags` string[] — A list of user-assigned tags to help manage the phone number.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `400` — Bad request, the request was unacceptable, often due to missing a required parameter.
- `401` — Unauthorized
- `404` — The requested resource doesn't exist.
- `422` — Unprocessable entity. Check the 'detail' field in response for details.
- `500` — 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/1571b0380bd7/schema)