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

# Delete a messaging hosted number order

`DELETE /messaging_hosted_number_orders/{id}`

Delete a messaging hosted number order and all associated phone numbers.

## Path parameters

- `id` string, required

## Response `200`

Successful response with details about a messaging hosted number order.

- object
  - `data` MessagingHostedNumberOrder
    - `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.
    - `phone_numbers` HostedNumber[]
      - `id` string, uuid — Identifies the type of resource.
      - `phone_number` string — The messaging hosted phone number (+E.164 format)
      - `record_type` string
      - `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'
    - `record_type` string — Identifies the type of the resource.
    - `status` 'carrier_rejected' | 'compliance_review_failed' | 'deleted' | 'failed' | 'incomplete_documentation' | 'incorrect_billing_information' | 'ineligible_carrier' | 'loa_file_invalid' | 'loa_file_successful' | 'pending' | 'provisioning' | 'successful'

## Other responses

- `4XX` — Unexpected error

## Changes

- **2026-08-17** `1571b0380bd7` — 3 breaking
  - the response's body type/format changed from `object`/`` to ``/`` for status `4XX`
  - the `errors/items/` response's property type/format changed from `object`/`` to ``/`` for status `4XX`
  - the `errors/items/code` response's property type/format changed from `integer`/`int32` to `string`/`` for status `4XX`
- **2026-08-04** `8f5f4e537994` — 4 breaking
  - the response's body type/format changed from ``/`` to `object`/`` for status `4XX`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `4XX`
  - the `errors/items/code` response's property type/format changed from `string`/`` to `integer`/`int32` for status `4XX`
  - the `errors/items/source/pointer` response's property type/format changed from `string`/`json-pointer` to `string`/`` for status `4XX`

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/messaging_hosted_number_orders/:id/delete.md)

---

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