Stash Documentation
Integration GuidesAPI ReferencePartner With UsChangelogInternal

Get prices

Retrieves uploaded pricing sheet data for the shop associated with the API key, filtered by region. Returns paginated price entries.

GET
/sdk/server/prices

Authorization

x-stash-hmac-signature<token>

Versioned HMAC-SHA256 signature authenticating server-to-server SDK requests (your backend calling Stash), as opposed to client-side SDK operations. Recommended over the deprecated X-Stash-Api-Key for the best security. Header format: v1;{appId};{unixMillisTimestamp};{base64Signature} (semicolon-delimited). {base64Signature} is the base64-encoded HMAC-SHA256 of the string {unixMillisTimestamp}.{requestBody} using your app ingress secret (the ingress secret is shown base64-encoded in Studio; base64-decode it to the raw bytes used as the HMAC key), where {requestBody} is the compact canonical request JSON for POST requests and empty for GET requests. The timestamp must be within 5 minutes of Stash server time. Your appId is your immutable app identifier, shown in Stash Studio under Project Settings > App details; your ingress secret is under Project Settings > API Secrets.

In: header

Query Parameters

region*string

ISO-3166-1 alpha-2 region/country code (e.g., 'PL', 'US', 'DE')

currency?string

Optional ISO-4217 currency code filter (e.g., 'PLN', 'USD', 'EUR')

platform?string

Optional platform filter. Omit or set to PRICING_PLATFORM_UNSPECIFIED to return all platforms.

Default"PRICING_PLATFORM_UNSPECIFIED"

Value in

  • "PRICING_PLATFORM_UNSPECIFIED"
  • "PRICING_PLATFORM_UNIVERSAL"
  • "PRICING_PLATFORM_IOS"
  • "PRICING_PLATFORM_ANDROID"
itemIds?array<string>

Optional filter to specific item IDs (SKUs). Response size is governed by limit/offset pagination, not by the number of item_ids.

limit?integer

Maximum number of items per page. Default 50, max 100. Values above 100 are clamped to 100.

Formatint64
offset?integer

Pagination offset. Default 0.

Formatint64

Response Body

application/json

application/json

curl -X GET "https://example.com/sdk/server/prices?region=string"
{  "prices": [    {      "itemId": "string",      "platform": "PRICING_PLATFORM_UNSPECIFIED",      "region": "string",      "currency": "string",      "priceCents": 0,      "decimalPlaces": 0    }  ],  "nextOffset": 0}

How is this guide?

Convert prices POST

Fetches pre-converted prices from the price sheet for the given destination country, applies tax based on region, and optionally applies custom rounding. Returns final prices in minor units and locale-formatted display strings.

Generate authenticated URL POST

Generates an authenticated URL for a specific target (home or loyalty) for a user. This endpoint is used for server-side URL generation.