---
title: "List order numbers"
method: GET
path: "/numbers"
tags: ["Number"]
---

# List order numbers

`GET /numbers`

Get a list of order numbers based on the customer's information.

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

A list of order numbers.

- object
  - `next_page_token` string — Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` NumberManagerNumber[]
    - `id` string, uuid — The unique identifier for the number.
    - `customer_id` string, uuid — The customer ID associated with the number. Returned from the `GET /customers` response.
    - `number` string — The phone number in E.164 format (normal) or +899 format (virtual).
    - `type` 'normal' | 'virtual' — The type of the number.
    - `call_flow_id` string, uuid — The unique identifier of the flow to execute for incoming calls. Returned from the `POST /flows` or `GET /flows` response.
    - `message_flow_id` string, uuid — The unique identifier of the flow to execute for incoming messages. Returned from the `POST /flows` or `GET /flows` response.
    - `name` string — The name of the number.
    - `detail` string — Additional details about the number.
    - `status` 'active' | 'deleted' — The status of the number.
    - `t38_enabled` boolean — Whether T38 is enabled for the number.
    - `emergency_enabled` boolean — Whether emergency services are enabled for the number.
    - `metadata` NumberManagerMetadata — Configuration flags for a number. Controls platform behavior such as RTP packet capture for debugging audio issues on this specific number. Updatable by CustomerAdmin or CustomerManager via `PUT /numbers/{id}/metadata`.
      - `rtp_debug` boolean — When set to `true`, RTPEngine captures RTP traffic as PCAP files for calls to this number. This flag is OR'd with the customer-level `rtp_debug` — if either is `true`, capture is enabled. Use this to debug audio quality issues on a specific number without enabling capture for all customer calls. Default is `false`. Enabling this increases storage usage — disable after debugging.
    - `tm_purchase` string, date-time — The timestamp of when the number was purchased.
    - `tm_renew` string, date-time — The timestamp of when the number was renewed.
    - `tm_create` string, date-time — The timestamp of when the number was created.
    - `tm_update` string, date-time — The timestamp of when the number was last updated.
    - `tm_delete` string, date-time — The timestamp of when the number was deleted.

## Other responses

- `401` — Authentication required (UNAUTHENTICATED).
- `500` — Internal error (INTERNAL).

---

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