---
title: "List Numbers"
method: GET
path: "/v1/numbers/list"
tags: ["numbers"]
---

# List Numbers

`GET /v1/numbers/list`

## Query parameters

- `page` integer
- `size` integer
- `sort_column` string, nullable
- `sort_desc` boolean, nullable

## Response `200`

Successful Response

- PhoneNumberPage
  - `items` NormalizedPhoneNumber[], required
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `active` boolean
    - `label` string
    - `inbound_agent` string, uuid, nullable
    - `outbound_only` boolean
    - `example_context` object, nullable
    - `number` string, required
    - `telephony_provider` 'vonage' | 'twilio'
    - `telephony_account_connection` union
      - string, uuid
      - TwilioAccountConnection
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `credentials` TwilioCredentials, required
          - `twilio_account_sid` string, required
          - `twilio_auth_token` string, required
        - `type` 'account_connection_twilio', required
        - `steering_pool` string[]
        - `account_supports_any_caller_id` boolean
  - `page` integer, required
  - `size` integer, required
  - `has_more` boolean, required
  - `total` integer, required
  - `total_is_estimated` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vocodedev/apis/vocode-hosted-api.md) · [All operations](https://skmtc.net/vocodedev/apis/vocode-hosted-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vocodedev/vocode-hosted-api/versions/ffca17c004e2/schema)