Accounts

Get countries list (base pricing)

Changed on

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.

get/v1/accounts/countries

Request

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

Query parameters

country_codesstring

Filter by country codes. Comma-separated list of ISO 3166-1 alpha-2 codes (e.g., 'US,RU,GB').

Example:US,RU,GB
sort'price_asc' | 'price_desc' | 'name_asc' | 'name_desc' | 'popularity_asc' | 'popularity_desc' required

Sort order for accounts.

Example:price_asc
pageinteger required

Page number.

Example:1
page_sizeinteger required

Number of items per page.

Example:50

Response

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

Example response

{
  "items": [
    {
      "country_code": "US",
      "emoji": "🇺🇸",
      "display_name": {
        "ru": "США",
        "en": "United States"
      },
      "price": {
        "amount": "1.50",
        "currency_code": "USD"
      },
      "base_price": {
        "amount": "1.50",
        "currency_code": "USD"
      },
      "available": true,
      "tags": [
        "HIGH_QUALITY"
      ],
      "popularity_index": 123,
      "available_count": 1034
    }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 50,
    "total_items": 150,
    "total_pages": 3,
    "has_next": true
  }
}

Changes

    • breaking

      the / response property's max was increased from 150.00 to 250.00 for the response status

    • info

      for the query request parameter page_size, the max was increased from 150.00 to 250.00

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status