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

# Get a store

`GET /v1/messaging/commerce/store`

## Request

- Base URL: `https://apihub.co.il`
- URL: `https://apihub.co.il/v1/messaging/commerce/store`
- Auth: HTTP bearer

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.


**Billing:** Read (free unless it says otherwise) · **Rate limit:** 120/min

## Query parameters

- `accountId` string, required: Connected store SocialAccount id.

## Headers

- `Idempotency-Key` string
- `X-Tag` string

## Response `200`

Completed

- object
  - `id` string: Execution id — stable across internal retries; use it with GET /v1/executions/{id}
  - `status` 'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
  - `operation` string
  - `tag` string, nullable: Your X-Tag, if sent
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `output` object: Operation result (see each operation). While a Studio render is processing: `stage` (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), `phase` (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), `progress` (a percent, 0–100) and `progress_fraction` (0–1), `eta_seconds` (seconds left, never below 0) and `estimate_seconds`
    - `store` object
      - `url` string, nullable, required: Public storefront URL.
      - `name` string, required
      - `domain` string, required: The platform domain of the store, e.g. my-store.myshopify.com.
      - `country` string, nullable, required: ISO 3166-1 alpha-2 country of the store.
      - `currency` string, required: ISO 4217 code the store sells in.
      - `platform` 'shopify' | 'woocommerce', required
      - `accountId` string, required: Zernio SocialAccount id of the store.
      - `capabilities` string[], required
      - `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).
      - `missingCapabilities` string[], required: Capabilities the platform supports that this store has not granted yet.
  - `error` string, nullable
  - `usage` object
    - `credits_charged` number, nullable
    - `credits_reserved` number
    - `estimated_credits` number
    - `cost_source` 'provider_reported' | 'calculated' | 'estimated' | 'null', nullable
    - `provider_usage` object, nullable: Normalised consumption, e.g. { VIDEO_SECOND: 22.4 }
  - `balance` object
    - `available` number
    - `reserved` number

## Other responses

- `400`: Invalid input
- `402`: Insufficient credits / project budget
- `404`: Resource not found (or not yours)
- `429`: Rate limited
- `503`: Service temporarily paused

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)