store

store returns the store identified by x-Store-Domain. Use it to read its identity, basic branding, commerce model, currency, and language without requesting the complete REST snapshot.

Signature

store: StorefrontStore!

The query takes no arguments and always returns StorefrontStore when the store context can be resolved.

StorefrontStore fields

Field	Type	Description
`id`	`String!`	Opaque public store identifier.
`name`	`String!`	Public store name.
`description`	`String!`	Public description; it can be an empty string.
`slug`	`String`	Assigned store slug, when present.
`domain`	`String`	Configured primary domain, when present.
`logo`	`String`	Public logo URL or reference, when present.
`icon`	`String`	Public icon URL or reference, when present.
`type`	`StoreType!`	Commerce model configured for the store.
`currency`	`String!`	Configured currency code, for example `PEN`.
`language`	`String!`	Configured language code, for example `en`.

Fields without ! can return null. Keep id as a string and do not try to interpret its format.

StoreType

type returns one of these exact values:

Value	Model
`B2C`	Online store that sells its own catalog.
`MARKETPLACE`	Store in which multiple sellers participate.
`RETAIL`	Retail operation.
`B2B`	Wholesale or business-to-business operation.
`SOCIAL`	Social commerce operation.
`HUB`	Hub that centralizes catalog and stock for external channels.
`RESTAURANT`	Restaurant or food operation.

Query

Store.graphql

query Store {
  store {
    id
    name
    description
    slug
    domain
    logo
    icon
    type
    currency
    language
  }
}

This operation does not need variables.

cURL

Terminal

curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: my-store" \
  --data-binary '{
    "query": "query Store { store { id name description slug domain logo icon type currency language } }"
  }'

Response

GraphQL returns only the requested fields:

Response

{
  "data": {
    "store": {
      "id": "123",
      "name": "Tienda",
      "description": "Descripción",
      "slug": "tienda",
      "domain": null,
      "logo": null,
      "icon": null,
      "type": "MARKETPLACE",
      "currency": "PEN",
      "language": "es"
    }
  }
}

Errors

Code	When it occurs
`STORE_CONTEXT_REQUIRED`	`x-Store-Domain` does not resolve a store.
`NOT_FOUND`	The context contains a store ID that can no longer be found.

Missing context

{
  "errors": [
    {
      "message": "Store context is required.",
      "path": ["store"],
      "extensions": {
        "code": "STORE_CONTEXT_REQUIRED"
      }
    }
  ],
  "data": null
}

Read GraphQL errors before using data: an HTTP 200 response can still contain errors.

REST equivalent

GET /v1/settings returns the complete public snapshot, including checkout, theme, features, pages, and menus. Use store when you only need the ten fields documented on this page.

store

On this page