**Version: 202601**

# List markets

**GET** `/openapi/2026-01/markets`

Retrieve all markets of the store with their configuration.

## Request

**Query Parameters**

- `only_active` boolean

  Whether to return only active markets. Defaults to false
- `with_countries_detail` boolean

  Whether to include per-country currency detail. Defaults to false

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `markets` object[]

    Markets

    *   Array \[

    - `id` string

      Market ID
    - `name` string

      Market name
    - `is_primary` boolean

      Whether this is the primary market
    - `is_default` boolean

      Whether this is the default market
    - `market_status` string

      Market status: active or paused
    - `countries` string[]

      Covered countries (ISO 3166-1 alpha-2)
    - `currency` string

      Base currency (ISO 4217)
    - `symbol` object

      Currency symbol detail

      - `val` string

        Symbol value (e.g., £)
      - `left` string

        Symbol placed to the left of the amount
      - `right` string

        Symbol placed to the right of the amount
      - `cn_name` string

        Chinese name of the currency
      - `title` string

        Currency title
      - `code` string

        Currency code (ISO 4217)
    - `local_currency_enabled` boolean

      Whether local-currency display is enabled
    - `countries_detail` object[]

      Per-country currency detail. Returned only when with\_countries\_detail is true in the request

      *   Array \[

      - `country_code` string

        Country code (ISO 3166-1 alpha-2)
      - `currency` string

        Currency code for this country
      - `symbol` object

        Currency symbol detail

        - `val` string

          Symbol value (e.g., £)
        - `left` string

          Symbol placed to the left of the amount
        - `right` string

          Symbol placed to the right of the amount
        - `cn_name` string

          Chinese name of the currency
        - `title` string

          Currency title
        - `code` string

          Currency code (ISO 4217)
      - `detail` object

        Country detail

        - `name` string

          Country name
        - `cn_name` string

          Country Chinese name
        - `continent` string

          Continent
        - `flag` string

          Flag emoji or identifier
        - `iso_code_2` string

          ISO 3166-1 alpha-2 code
        - `iso_code_3` string

          ISO 3166-1 alpha-3 code
      *   \]
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "markets": [
      {
        "id": "string",
        "name": "string",
        "is_primary": true,
        "is_default": true,
        "market_status": "string",
        "countries": [
          "string"
        ],
        "currency": "string",
        "symbol": {
          "val": "string",
          "left": "string",
          "right": "string",
          "cn_name": "string",
          "title": "string",
          "code": "string"
        },
        "local_currency_enabled": true,
        "countries_detail": [
          {
            "country_code": "string",
            "currency": "string",
            "symbol": {
              "val": "string",
              "left": "string",
              "right": "string",
              "cn_name": "string",
              "title": "string",
              "code": "string"
            },
            "detail": {
              "name": "string",
              "cn_name": "string",
              "continent": "string",
              "flag": "string",
              "iso_code_2": "string",
              "iso_code_3": "string"
            }
          }
        ]
      }
    ]
  }
}
```