---
title: "Get a store"
method: GET
path: "/v1/commerce/store"
tags: ["Commerce"]
---

# Get a store

`GET /v1/commerce/store`

Returns the connected store with its currency, country and the
`capabilities` it supports, so an integration can tell up front which
Commerce operations the store serves. On Shopify, stock, sales
channels, discounts, navigation, metaobjects, markets, marketing and
image removal need permissions the store owner approves separately:
`missingCapabilities` lists what is not granted yet and
`grantPermissionsUrl` is the page where the owner approves it.

## Query parameters

- `accountId` string, required

## Response `200`

Store fetched

- object
  - `store` CommerceStore
    - `accountId` string, required — Zernio SocialAccount id of the store.
    - `platform` 'shopify' | 'woocommerce', required
    - `name` string, required
    - `domain` string, required — The platform domain of the store, e.g. my-store.myshopify.com.
    - `url` string, nullable, required — Public storefront URL.
    - `currency` string, required — ISO 4217 code the store sells in.
    - `country` string, nullable, required — ISO 3166-1 alpha-2 country of the store.
    - `capabilities` CommerceCapability[], required
    - `missingCapabilities` CommerceCapability[], required — Capabilities the platform supports that this store has not granted yet.
    - `grantPermissionsUrl` string, nullable, required — Shopify: a page in the Shopify admin where the store owner approves the permissions missingCapabilities need, on the existing install (no reinstall; they can revoke them later). Null when nothing is missing or the store cannot grant them this way (a store connected with its own custom-app token).

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — The platform rejected the request (code insufficient_permissions). Reconnect the store.
- `404` — Account not found or not accessible (code account_not_found).
- `429` — Rate limited, either by Zernio or by the platform. Retry later.

## Changes

- **2026-09-30** `16a7b9d5373e` — 1 info
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `400`
- **2026-09-29** `69bbe3da3a18` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/commerce/store/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/16a7b9d5373e?raw)