Stash Documentation
Integration GuidesAPI ReferencePartner with usChangelog

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

regionstring

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.

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

curl -X GET "https://test-api.stash.gg/sdk/server/prices?region=string&currency=string&platform=PRICING_PLATFORM_UNSPECIFIED&itemIds=string&limit=0&offset=0"
{
  "prices": [
    {
      "itemId": "string",
      "platform": "PRICING_PLATFORM_UNSPECIFIED",
      "region": "string",
      "currency": "string",
      "priceCents": 0,
      "decimalPlaces": 0
    }
  ],
  "nextOffset": 0
}
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string",
      "property1": null,
      "property2": null
    }
  ]
}

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.