**Version: 202607**

# Get market

**GET** `/openapi/2026-07/markets/:id`

Retrieve full detail of a single market, including domain, pricing, tax, language and status.

## Request

**Path Parameters**

- `id` string (required)

  Market ID

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `market` object

    Market detail

    - `id` string

      Market ID
    - `market_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
    - `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)
    - `domain_type` string

      Domain mode: primary or sub\_path
    - `domain_value` string

      Domain value (primary domain or sub-path suffix)
    - `custom_rate_enabled` boolean

      Whether a custom exchange rate is enabled. Read-only; cannot be modified via the price update endpoint
    - `custom_exchange_rate` double

      Custom exchange rate value. Read-only
    - `price_adjust` int64

      Price adjustment percentage. Range -99 to 999
    - `local_currency_enabled` boolean

      Whether local-currency display is enabled
    - `product_tax_included` boolean

      Whether product prices already include tax
    - `default_language` string

      Default language code (IETF) of this market
    - `countries` string[]

      Covered countries (ISO 3166-1 alpha-2)
    - `languages` object[]

      Languages configured on this market

      *   Array \[

      - `code` string

        IETF language code (e.g., zh-CN)
      - `name` string

        Language display name
      - `is_enabled` boolean

        Whether the language is enabled
      - `url` string

        Storefront URL of the language under this market
      - `is_default` boolean

        Whether this language is the market's default language
      *   \]
    - `language_manageable` boolean

      Whether languages of this market are manageable
    - `url` string

      Storefront URL of this market
    - `created_at` string

      Creation time, formatted as ISO-8601
    - `updated_at` string

      Last update time, formatted as ISO-8601
    - `actual_rate` double

      Actual exchange rate
    - `exchange_rate` object

      Exchange rate detail

      - `currency` string

        Source currency code (ISO 4217)
      - `to_currency` string

        Target currency code (ISO 4217)
      - `rate` double

        Exchange rate value
      - `last_updated_at` string

        Last update time of the rate, formatted as ISO-8601
    - `back_exchange_rate` object

      Reverse exchange rate detail

      - `currency` string

        Source currency code (ISO 4217)
      - `to_currency` string

        Target currency code (ISO 4217)
      - `rate` double

        Exchange rate value
      - `last_updated_at` string

        Last update time of the rate, formatted as ISO-8601
    - `setting` object

      Market storefront settings

      - `redirect_enabled` boolean

        Whether market redirect is enabled
      - `price_round_enabled` boolean

        Whether price rounding is enabled
      - `geolocation_app_installed` boolean

        Whether the geolocation app is installed
      - `language_selector_enabled` boolean

        Whether the language selector is enabled
    - `delivery_country_limited` boolean

      Whether delivery countries are limited for this market

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "market": {
      "id": "string",
      "market_name": "string",
      "is_primary": true,
      "is_default": true,
      "market_status": "string",
      "currency": "string",
      "symbol": {
        "val": "string",
        "left": "string",
        "right": "string",
        "cn_name": "string",
        "title": "string",
        "code": "string"
      },
      "domain_type": "string",
      "domain_value": "string",
      "custom_rate_enabled": true,
      "custom_exchange_rate": 0,
      "price_adjust": 0,
      "local_currency_enabled": true,
      "product_tax_included": true,
      "default_language": "string",
      "countries": [
        "string"
      ],
      "languages": [
        {
          "code": "string",
          "name": "string",
          "is_enabled": true,
          "url": "string",
          "is_default": true
        }
      ],
      "language_manageable": true,
      "url": "string",
      "created_at": "string",
      "updated_at": "string",
      "actual_rate": 0,
      "exchange_rate": {
        "currency": "string",
        "to_currency": "string",
        "rate": 0,
        "last_updated_at": "string"
      },
      "back_exchange_rate": {
        "currency": "string",
        "to_currency": "string",
        "rate": 0,
        "last_updated_at": "string"
      },
      "setting": {
        "redirect_enabled": true,
        "price_round_enabled": true,
        "geolocation_app_installed": true,
        "language_selector_enabled": true
      },
      "delivery_country_limited": true
    }
  }
}
```