---
title: "Number Order Status Update"
method: POST
path: "numberOrderStatusUpdate"
tags: ["Callbacks"]
---

# Number Order Status Update

`POST numberOrderStatusUpdate` (webhook)

This webhook uses Telnyx headers (telnyx-timestamp, telnyx-signature-ed25519) that are compatible with Standard Webhooks specification for SDK generation. Custom validation logic can map these to standard webhook-timestamp and webhook-signature equivalents. See https://github.com/standard-webhooks/standard-webhooks for details.

## Headers

- `telnyx-timestamp` integer, required — Unix timestamp for replay attack prevention
- `telnyx-signature-ed25519` string, required — Ed25519 signature of timestamp|payload for verification

## Payload

- NumberOrderWebhookEvent
  - `data` object, required
    - `event_type` string, required — The type of event being sent
    - `id` string, uuid, required — Unique identifier for the event
    - `occurred_at` string, date-time, required — ISO 8601 timestamp of when the event occurred
    - `payload` NumberOrderWithPhoneNumbers, required
      - `id` string, uuid
      - `record_type` string
      - `phone_numbers_count` integer — The count of phone numbers in the number order.
      - `connection_id` string — Identifies the connection associated with this phone number.
      - `messaging_profile_id` string — Identifies the messaging profile associated with the phone number.
      - `billing_group_id` string — Identifies the messaging profile associated with the phone number.
      - `phone_numbers` PhoneNumber[]
        - `id` string, uuid
        - `record_type` string
        - `phone_number` string
        - `country_iso_alpha2` string — The ISO 3166-1 alpha-2 country code of the phone number.
        - `regulatory_requirements` SubNumberOrderRegulatoryRequirementWithValue[]
          - `record_type` string
          - `requirement_id` string, uuid — Unique id for a requirement.
          - `field_type` 'textual' | 'datetime' | 'address' | 'document'
          - `field_value` string — The value of the requirement, this could be an id to a resource or a string value.
        - `requirements_met` boolean — True if all requirements are met for a phone number, false otherwise.
        - `requirements_status` 'pending' | 'approved' | 'cancelled' | 'deleted' | 'requirement-info-exception' | 'requirement-info-pending' | 'requirement-info-under-review' — Status of document requirements (if applicable)
        - `status` 'pending' | 'success' | 'failure' — The status of the phone number in the order.
        - `bundle_id` string, uuid
        - `phone_number_type` 'local' | 'mobile' | 'national' | 'shared_cost' | 'toll_free' — Phone number type
        - `country_code` string — Country code of the phone number
      - `sub_number_orders_ids` string[]
      - `status` 'pending' | 'success' | 'failure' — The status of the order.
      - `customer_reference` string — A customer reference string for customer look ups.
      - `created_at` string, date-time — An ISO 8901 datetime string denoting when the number order was created.
      - `updated_at` string, date-time — An ISO 8901 datetime string for when the number order was updated.
      - `requirements_met` boolean — True if all requirements are met for every phone number, false otherwise.
    - `record_type` string, required — Type of record
  - `meta` object, required
    - `attempt` integer, required — Webhook delivery attempt number
    - `delivered_to` string, uri, required — URL where the webhook was delivered

## Acknowledgement `200`

The server must return a HTTP 200, otherwise we will reattempt to deliver the webhook to the failover URL.

---

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