---
title: "Get countries list (base pricing)"
method: GET
path: "/v1/accounts/countries"
tags: ["Accounts"]
---

# Get countries list (base pricing)

`GET /v1/accounts/countries`

## Request

- Base URL: `https://api.getmytg.com`
- URL: `https://api.getmytg.com/v1/accounts/countries`
- Auth: none required

Returns paginated list of all available countries with **base pricing** (no user discount applied). No authentication required.

**Use case.** Public catalog for the website landing page. Shows general pricing and stock availability.

**Pricing.** Prices are base prices before any user discount. For personalized pricing, use `GET /accounts` (requires authentication).

**Filtering.** Use `country_codes` to request specific countries (e.g., `US,RU,GB`).

**Sorting options:** `price_asc`, `price_desc`, `name_asc`, `name_desc`, `popularity_asc`, `popularity_desc`.

## Query parameters

- `country_codes` string: Filter by country codes. Comma-separated list of ISO 3166-1 alpha-2 codes (e.g., 'US,RU,GB').
- `sort` 'price_asc' | 'price_desc' | 'name_asc' | 'name_desc' | 'popularity_asc' | 'popularity_desc', required: Sort order for accounts.
- `page` integer, required: Page number.
- `page_size` integer, required: Number of items per page.

## Response `200`

Public catalog of available countries with base pricing (without user discount).

- object: Public catalog of available countries with base pricing (without user discount).
  - `items` object[], required
    - `country_code` string, required: ISO 3166-1 alpha-2 country code (e.g., US, RU, GB).
    - `emoji` string, required: Country flag emoji.
    - `display_name` object, required
      - `ru` string, required: Name in Russian.
      - `en` string, required: Name in English.
    - `price` object, required
      - `amount` string, required: Monetary amount as a string with up to 2 decimal places.
      - `currency_code` string, required: ISO 4217 currency code.
    - `base_price` object, required
      - `amount` string, required: Monetary amount as a string with up to 2 decimal places.
      - `currency_code` string, required: ISO 4217 currency code.
    - `available` boolean, required: Indicates if account is available for purchase.
    - `tags` string[], required: Account tags (e.g., HIGH_QUALITY for premium accounts).
    - `popularity_index` number, required: Relative popularity of this country based on recent purchase volume.
    - `available_count` number, nullable: Number of available accounts for this country.
  - `pagination` object, required
    - `current_page` integer, required: Current page number.
    - `page_size` integer, required: Number of items per page.
    - `total_items` integer, required: Total number of items.
    - `total_pages` integer, required: Total number of pages.
    - `has_next` boolean, required: Whether there is a next page.
    - `has_previous` boolean, required: Whether there is a previous page.

## Other responses

- `400`: Response for status 400
- `500`: Internal server error

## Changes

- **2026-11-03** `aa3ff24cbee2`: 1 breaking, 5 info
  - the `pagination/page_size` response property's max was increased from `150.00` to `250.00` for the response status `200`
  - for the `query` request parameter `page_size`, the max was increased from `150.00` to `250.00`
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`
  - …2 more

[Operation history](https://skmtc.dev/getmytg/apis/get-my-tg-api/changes/v1/accounts/countries/get.md)

---

[API](https://skmtc.dev/getmytg/apis/get-my-tg-api.md) - [All operations](https://skmtc.dev/getmytg/apis/get-my-tg-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmytg/apis/get-my-tg-api/revisions/aa3ff24cbee2?raw)