---
title: "Delete a messaging hosted number"
method: DELETE
path: "/messaging_hosted_numbers/{id}"
tags: ["Hosted Numbers"]
---

# Delete a messaging hosted number

`DELETE /messaging_hosted_numbers/{id}`

## Path parameters

- `id` string, required

## Response `200`

Successful response with details about a messaging hosted number order.

- object
  - `data` MessagingHostedNumberOrder
    - `record_type` string — Identifies the type of the resource.
    - `id` string, uuid — Resource unique identifier.
    - `messaging_profile_id` string, nullable — Automatically associate the number with this messaging profile ID when the order is complete.
    - `status` 'carrier_rejected' | 'compliance_review_failed' | 'deleted' | 'failed' | 'incomplete_documentation' | 'incorrect_billing_information' | 'ineligible_carrier' | 'loa_file_invalid' | 'loa_file_successful' | 'pending' | 'provisioning' | 'successful'
    - `phone_numbers` HostedNumber[]
      - `record_type` string
      - `id` string, uuid — Identifies the type of resource.
      - `phone_number` string — The messaging hosted phone number (+E.164 format)
      - `status` 'deleted' | 'failed' | 'failed_activation' | 'failed_carrier_rejected' | 'failed_ineligible_carrier' | 'failed_number_already_hosted' | 'failed_number_not_found' | 'failed_ownership_verification' | 'failed_timeout' | 'pending' | 'provisioning' | 'successful'

## Other responses

- `4XX` — 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/versions/8f5f4e537994/schema)