> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# market

> Fetch a single market by its id.

**Required scopes:** [`markets_read`](/docs/api-reference/v3/reference/scopes#scope-markets_read)

## Arguments

<ResponseField name="id" type="ID!" required>
  The id of the market to fetch.
</ResponseField>

## Returns

<ResponseField name="market" type={<a href="/docs/api-reference/v3/reference/markets/market">Market</a>}>
  A cross-border market: a set of destination countries that share one landed-cost pricing policy.

  <Expandable title="fields" lazyRender>
    <ResponseField name="breakdownDisplay" type={<a href="/docs/api-reference/v3/reference/markets/landed-cost-breakdown-display">LandedCostBreakdownDisplay!</a>} required>
      How uncharged landed-cost lines appear in the checkout breakdown.
    </ResponseField>

    <ResponseField name="breakdownLabels" type={<a href="/docs/api-reference/v3/reference/markets/market-breakdown-labels">MarketBreakdownLabels!</a>} required>
      Custom labels for the checkout landed-cost breakdown.

      <Expandable title="fields" lazyRender>
        <ResponseField name="dutiesAndFees" type="String">
          The label for the duties and fees line.
        </ResponseField>

        <ResponseField name="shipping" type="String">
          The label for the shipping line.
        </ResponseField>

        <ResponseField name="taxes" type="String">
          The label for the taxes line.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="countries" type={<a href="/docs/api-reference/v3/reference/markets/market-country">[MarketCountry!]!</a>} required>
      The destination countries this market sells into.

      <Expandable title="fields" lazyRender>
        <ResponseField name="countryCode" type={<a href="/docs/api-reference/v3/reference/common/country-code">CountryCode!</a>} required>
          The destination country.
        </ResponseField>

        <ResponseField name="createdAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
          When the country was added to the market.
        </ResponseField>

        <ResponseField name="currency" type="String">
          The ISO 4217 currency shoppers in this country are charged in. Null until the country has been set up on the sales channel.
        </ResponseField>

        <ResponseField name="updatedAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
          When the record was last updated.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="coveredByMarkup" type={<a href="/docs/api-reference/v3/reference/markets/landed-cost-component">[LandedCostComponent!]!</a>} required>
      Landed-cost components whose checkout charge is absorbed by the markup, drawn down in order.
    </ResponseField>

    <ResponseField name="createdAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
      When the record was created.
    </ResponseField>

    <ResponseField name="enabled" type="Boolean!" required>
      Whether the market's pricing is live.
    </ResponseField>

    <ResponseField name="excludedFromCheckout" type={<a href="/docs/api-reference/v3/reference/markets/landed-cost-component">[LandedCostComponent!]!</a>} required>
      Landed-cost components neither charged nor shown at checkout.
    </ResponseField>

    <ResponseField name="id" type="ID!" required>
      The id of this market.
    </ResponseField>

    <ResponseField name="includedInPrice" type={<a href="/docs/api-reference/v3/reference/markets/landed-cost-component">[LandedCostComponent!]!</a>} required>
      Landed-cost components baked into product prices.
    </ResponseField>

    <ResponseField name="lastSyncedAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime</a>}>
      When prices were last pushed to the sales channel. Null until the first sync.
    </ResponseField>

    <ResponseField name="markup" type={<a href="/docs/api-reference/v3/reference/common/decimal">Decimal!</a>} required>
      The markup on the base price, as a fraction (e.g. "0.1" for 10%).
    </ResponseField>

    <ResponseField name="markupStrategy" type={<a href="/docs/api-reference/v3/reference/markets/market-markup-strategy">MarketMarkupStrategy!</a>} required>
      How the markup combines with the landed cost in the price.
    </ResponseField>

    <ResponseField name="name" type="String">
      The merchant-set name. Null when unnamed; the countries then identify the market.
    </ResponseField>

    <ResponseField name="pricingMode" type={<a href="/docs/api-reference/v3/reference/markets/market-pricing-mode">MarketPricingMode!</a>} required>
      How landed costs are turned into prices.
    </ResponseField>

    <ResponseField name="shopCurrency" type="String!" required>
      The ISO 4217 currency of the store's base prices, which the market's prices are converted from.
    </ResponseField>

    <ResponseField name="updatedAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
      When the record was last updated.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```graphql theme={null}
query {
  market(id: "...") {
    breakdownDisplay
    coveredByMarkup
    createdAt
    enabled
    excludedFromCheckout
    id
    includedInPrice
    lastSyncedAt
    # ...
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.