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

# Get countries list (personal pricing)

`GET /v1/accounts/`

## Request

- Base URL: `https://api.getmytg.com`
- URL: `https://api.getmytg.com/v1/accounts/`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns paginated list of available accounts with **user-specific pricing** (personal discount applied).

**Pricing.** Prices reflect the authenticated user's discount level. To see base prices without discount, use `GET /accounts/countries`.

**Difference from `/accounts/countries`:**
- Requires authentication
- Prices include user's personal discount

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

Successful response.

- object: Successful response.
  - `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
- `401`: Response for status 401
- `403`: Response for status 403
- `429`: Response for status 429
- `500`: Internal server error

## Changes

- **2026-11-03** `aa3ff24cbee2`: 1 breaking, 8 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 `401`
  - …5 more

[Operation history](https://skmtc.dev/getmytg/apis/get-my-tg-api/changes/v1/accounts/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)
