List countries in a market - Spree Commerce documentation

GET

api

store

markets

{market_id}

countries

Spree SDK

import { createClient } from '@spree/sdk'

const client = createClient({
  baseUrl: 'https://your-store.com',
  publishableKey: '<api-key>',
})

const countries = await client.markets.countries.list('mkt_xxx')

{
  "data": [
    {
      "iso": "FR",
      "iso3": "IS79",
      "name": "France",
      "states_required": false,
      "zipcode_required": true
    },
    {
      "iso": "DE",
      "iso3": "IS78",
      "name": "Germany",
      "states_required": false,
      "zipcode_required": true
    }
  ]
}

Authorizations

x-spree-api-key

string

header

required

Publishable API key for store access

Headers

x-spree-api-key

string

required

Path Parameters

market_id

string

required

Market prefixed ID

Query Parameters

fields

string

Comma-separated list of fields to include (e.g., name,slug,price). id is always included.

Response

200 - application/json

countries found

data

array

required

Resolve market by country

Get a country in a market

⌘I

Spree SDK

import { createClient } from '@spree/sdk'

const client = createClient({
  baseUrl: 'https://your-store.com',
  publishableKey: '<api-key>',
})

const countries = await client.markets.countries.list('mkt_xxx')

{
  "data": [
    {
      "iso": "FR",
      "iso3": "IS79",
      "name": "France",
      "states_required": false,
      "zipcode_required": true
    },
    {
      "iso": "DE",
      "iso3": "IS78",
      "name": "Germany",
      "states_required": false,
      "zipcode_required": true
    }
  ]
}