---
title: "Changes to List Numbers"
method: GET
path: "/v1/numbers/list"
---

# Changes to List Numbers

`GET /v1/numbers/list`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 31 revisions.

- **2024-08-14** `63991d99e2e1` — 3 breaking, 6 info
- **2024-04-19** `55ae0e0bb01f` — 2 info
- **2024-04-15** `47ab17602d64` — 2 info
- **2024-03-18** `8b2983fa7531` — 5 info
- **2024-03-18** `500a519452b0` — 2 warning, 1 info
- **2023-11-25** `97850bfccb2c` — 2 info
- **2023-10-13** `9feade6bcba8` — 1 info
- **2023-10-05** `f4d951d6fa94` — 1 info

## Changes

- **2024-08-14** `63991d99e2e1` — 3 breaking, 6 info
  - the response property `items/items/inbound_agent` became optional for the status `200`
  - response property `items/items/example_context` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/inbound_agent` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - `query` request parameter `sort_column` list-of-types was widened by adding types `null`
  - `query` request parameter `sort_desc` list-of-types was widened by adding types `null`
  - for the `query` request parameter `sort_column`, the type/format was generalized from `string`/`` to ``/``
  - for the `query` request parameter `sort_desc`, the type/format was generalized from `boolean`/`` to ``/``
  - added `subschema #3` to the `items/items/telephony_account_connection` response property `anyOf` list for the response status `200`
  - the `type` response property const value `account_connection_twilio` was added for the status `200`
- **2024-04-19** `55ae0e0bb01f` — 2 info
  - added the required property `total` to the response with the `200` status
  - added the required property `total_is_estimated` to the response with the `200` status
- **2024-04-15** `47ab17602d64` — 2 info
  - added the optional property `items/items/telephony_account_connection/anyOf[subschema #2: TwilioAccountConnection]/account_supports_any_caller_id` to the response with the `200` status
  - added the optional property `items/items/telephony_account_connection/anyOf[subschema #2: TwilioAccountConnection]/steering_pool` to the response with the `200` status
- **2024-03-18** `8b2983fa7531` — 5 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `size`
  - added the new optional `query` request parameter `sort_column`
  - added the new optional `query` request parameter `sort_desc`
  - added the non-success response with the status `422`
- **2024-03-18** `500a519452b0` — 2 warning, 1 info
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `size`
  - removed the non-success response with the status `422`
- **2023-11-25** `97850bfccb2c` — 2 info
  - added the optional property `items/items/telephony_account_connection` to the response with the `200` status
  - added the optional property `items/items/telephony_provider` to the response with the `200` status
- **2023-10-13** `9feade6bcba8` — 1 info
  - added the optional property `items/items/example_context` to the response with the `200` status
- **2023-10-05** `f4d951d6fa94` — 1 info
  - added the optional property `items/items/outbound_only` to the response with the `200` status

---

[Operation](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/docs/v1/numbers/list/get.md) · [API](https://skmtc.dev/vocodedev/apis/vocode-hosted-api.md) · [Page](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/numbers/list/get)