---
title: "List available phone numbers"
method: GET
path: "/v1/buy/countries/{country_id}/cities/{city_id}/dids"
tags: ["Buy"]
---

# List available phone numbers

`GET /v1/buy/countries/{country_id}/cities/{city_id}/dids`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/buy/countries/{country_id}/cities/{city_id}/dids`
- Auth: HTTP bearer

Returns a paginated list of phone numbers available for purchase in the specified city.

## Path parameters

- `country_id` integer, required
- `city_id` integer, required

## Query parameters

- `text_enabled_only` boolean
- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of available phone numbers.

- AvailableNumberListResponse
  - `dids` AvailableNumber[], required: Phone numbers available for purchase that match the search criteria.
    - `id` integer, required: Phone number ID.
    - `activation_fee` string, required: One-time activation fee in USD.
    - `monthly_fee` string, required: Monthly fee in USD.
    - `per_min` string, required: Price per inbound minute in USD.
    - `channels` string, int32, required: Maximum number of concurrent inbound calls.
    - `city` string, required: City where the phone number originates.
    - `country` string, required: Country where the phone number originates.
    - `country_short_name` string, required: Two-letter ISO country code.
    - `cnam` boolean, nullable, required: Indicates whether CNAM can be activated.
    - `free_min` integer, required: Number of free inbound minutes.
    - `number` string, required: Phone number in E.164 format.
    - `require_docs` DocumentType[], required: Documents to activate the number.
    - `sms_enabled` boolean, required: Indicates whether the phone number can receive inbound SMS and MMS messages.
    - `sms_price` number, float, required: Price per inbound SMS segment in USD.
    - `domestic_cli` boolean: Indicates whether the number can be used as the Caller ID for local calls.
  - `pagination` Pagination, required
    - `current_page` integer, required: Current page number.
    - `per_page` integer, required: Number of records per page.
    - `total` integer, required: Total number of records.
    - `total_pages` integer, required: Total number of pages.

## Other responses

- `400`: Request failed. Missing or invalid parameter <param_name>
- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.
- `404`: Request failed. An object with the specified ID is not found.

## Changes

- **2026-09-21** `76b9ec29392a`: 1 breaking, 3 warning
  - the `dids/items/require_docs/items/` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `200`
  - added the new `address` enum value to the `dids/items/require_docs/items/` response property for the response status `200`
  - added the new `id` enum value to the `dids/items/require_docs/items/` response property for the response status `200`
  - added the new `localaddress` enum value to the `dids/items/require_docs/items/` response property for the response status `200`
- **2026-09-08** `6a89c962481c`: 1 breaking, 4 info
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/AvailableNumberListResponse, subschema #2` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `401`
  - added the required property `dids` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/buy/countries/:country_id/cities/:city_id/dids/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)