Skip to content

Get the store a key reads

GET
/commerce/delivery/v1/store
curl --request GET \
--url https://api.ebitex.io/commerce/delivery/v1/store \
--header 'Authorization: Bearer <token>'

Returns the store this key is bound to: its key, name, currency (an ISO 4217 code, fixed for the store), pricesIncludeTax and currencies (every currency the store sells in, its own first: the values currency accepts on a read or a cart). Useful to confirm which store a key reads, and to format prices.

The response carries an ETag; send it back as If-None-Match and an unchanged answer is 304. Responses are private, no-cache: revalidate rather than store.

Key: a Commerce delivery key (commerce.delivery.read), minted for one store in Commerce. A key with an origin or IP restriction is browser-safe: it reads the same catalogue, but is told exact stock counts only if the store allows it.

{ "key": "uk", "name": "UK shop", "currency": "GBP", "pricesIncludeTax": true, "currencies": ["GBP", "EUR"] }

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired, or its store binding was removed.

payment_required: the organization’s subscription needs attention.

scope_denied: the key lacks commerce.delivery.read. app_not_available: Commerce is not enabled for the organization. origin_denied or ip_denied: the key was used from an origin or address outside its restrictions.

rate_limited: the key spent its requests-per-minute budget; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.