---
title: "List countries"
method: GET
path: "/v1/buy/countries"
tags: ["Buy"]
---

# List countries

`GET /v1/buy/countries`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/buy/countries`
- Auth: HTTP bearer

Returns a list of countries where phone numbers are available.

## Query parameters

- `text_enabled_only` boolean

## Response `200`

Returns the list of countries with available phone numbers.

- CountryListResponse
  - `countries` Country[], required: Countries where phone numbers are available.
    - `id` integer, required: Country ID.
    - `name` string, required: Country name.
    - `has_provinces_or_states` boolean, required: Indicates whether the country has regions.

## Other responses

- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.

## Changes

- **2026-09-08** `6a89c962481c`: 1 breaking, 3 info
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/CountryListResponse, 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 `countries` to the response with the `200` status
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1`: 3 info
  - api operation id `Getalistofcountries` removed and replaced with `buy_countries_list`
  - added `#/components/schemas/CountryListResponse` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/BuyCountriesResponse` from the response body `allOf` list for the response status `200`
- **2026-02-12** `fabaadf195a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/buy/countries/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)