---
title: "Get Player Store Items"
method: GET
path: "/v1/players/{player_id}/store_items"
tags: ["Players' Store Items"]
---

# Get Player Store Items

`GET /v1/players/{player_id}/store_items`

Returns the store built for the player, the same way the Game Hub builds it.

Prices, discounts, bonuses and purchase limits are personalized: store
promotions, segments, campaigns and the player's own purchase history are
all applied, so the response is what the player would see on the Game Hub.

The store is priced with the `country` and the `platform` of the player, set
by `PUT /players/{player_id}`, so the endpoint takes no pricing parameters.
Order the offers it returns by passing their `id` as `items[].store_item_id`
to `POST /orders`.

## Path parameters

- `player_id` string, required

## Response `200`

Successful Response

- PlayerStoreItem[]
  - `id` string, required — The unique identifier of the store item the offer comes from
  - `item_id` string, required — The unique identifier of the item the offer sells
  - `sku` string, required — The SKU of the item
  - `type` 'item' | 'currency' | 'bundle' | 'lootbox' | 'subscription' | 'virtual_currency' | 'piggy_bank', required
  - `name` string, required — The name of the item
  - `description` string — The description of the item
  - `image_url` union — The URL of the image for the item
    - string, uri
    - ''
  - `background_image_url` union — The URL of the background image for the item
    - string, uri
    - ''
  - `background_image_color` string — The color of the background image for the item
  - `currency` 'USD' | 'EUR' | 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'UYU' | 'UZS' | 'VED' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XCG' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWG' | 'ZWL' | 'RP' | 'VC', required
  - `price` integer — The price of the item in minor [currency units](https://docs.aghanim.com/currencies/)
  - `price_after_discount` integer — The price the player pays after all discounts are applied
  - `discount_percent` integer — The discount percent applied to the item
  - `is_free_item` boolean — Whether the item is given for free
  - `quantity` integer — The base quantity of the item
  - `quantity_after_bonus` integer — The quantity the player receives with the bonus
  - `bonus_percent` integer — The bonus percent applied to the quantity
  - `disabled` boolean — Whether the item is not available for purchase or claim
  - `max_purchases` integer — How many times the item can be purchased
  - `purchases_left` integer — How many purchases the player has left
  - `next_purchase_at` number — When the item becomes purchasable again
  - `expires_at` integer — When the offer for the item expires
  - `nested_items` PlayerStoreNestedItem[] — The child items of the bundle or the lootbox
    - `item_id` string, required — The unique identifier of the item
    - `sku` string, required — The SKU of the item
    - `name` string, required — The name of the item
    - `type` 'item' | 'currency' | 'bundle' | 'lootbox' | 'subscription' | 'virtual_currency' | 'piggy_bank', required
    - `quantity` integer — The quantity of the item
    - `image_url` union — The URL of the image for the item
      - string, uri
      - ''

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `1816e2044c07` — 2 warning
  - added the new `piggy_bank` enum value to the `items/nested_items/items/type` response property for the response status `200`
  - added the new `piggy_bank` enum value to the `items/type` response property for the response status `200`
- **2026-09-16** `6d6269f8cab6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/changes/v1/players/:player_id/store_items/get.md)

---

[API](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/revisions/32e27bc547ae?raw)