---
title: marketByGeography - GraphQL Admin
description: Returns the applicable market for a customer based on where they are in the world.
api_version: 2025-10
api_name: admin
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/queries/marketbygeography
  md: https://shopify.dev/docs/api/admin-graphql/latest/queries/marketbygeography.md
---

# market​By​Geography

query

Requires The user must have markets API access.

Deprecated. This [market\_by\_geography](https://shopify.dev/docs/api/admin-graphql/latest/queries/market_by_geography) field will be removed in a future version of the API.

Returns the applicable market for a customer based on where they are in the world.

## Arguments

* country​Code

  [Country​Code!](https://shopify.dev/docs/api/admin-graphql/latest/enums/CountryCode)

  required

  The code for the country where the customer is.

***

## Possible returns

* Market

  [Market](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market)

  A market is a group of one or more regions that you want to target for international sales. By creating a market, you can configure a distinct, localized shopping experience for customers from a specific area of the world. For example, you can [change currency](https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate), [configure international pricing](https://shopify.dev/apps/internationalization/product-price-lists), or [add market-specific domains or subfolders](https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence).

***

## Examples

* ### marketByGeography reference

## Query Reference

```graphql
{
  marketByGeography(countryCode) {
    # marketByGeography fields
  }
}
```