---
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`

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.

- object
  - `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` integer[], required — Documents required to activate the phone 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>
- `403` — Request failed. The feature is disabled for your account.
- `404` — Request failed. An object with the specified ID is not found.

---

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