Skip to main content
GET
/
api
/
v3
/
store
/
markets
/
resolve
Spree SDK
import { createClient } from '@spree/sdk'

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

const market = await client.markets.resolve('DE')
{
  "id": "mkt_gbHJdmfrXB",
  "name": "Europe",
  "currency": "EUR",
  "default_locale": "de",
  "tax_inclusive": true,
  "default": false,
  "supported_locales": [
    "de",
    "en",
    "fr"
  ],
  "countries": [
    {
      "iso": "DE",
      "iso3": "IS74",
      "name": "Germany",
      "states_required": false,
      "zipcode_required": true
    },
    {
      "iso": "FR",
      "iso3": "IS75",
      "name": "France",
      "states_required": false,
      "zipcode_required": true
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-spree-api-key
string
header
required

Publishable API key for store access

Headers

​
x-spree-api-key
string
required

Query Parameters

​
country
string
required

Country ISO 3166-1 alpha-2 code (e.g., "DE", "US")

​
fields
string

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

Response

market resolved

The response is of type object.