---
title: "Get Wishlist"
method: GET
path: "/api/account/wishlist"
tags: ["wishlist"]
---

# Get Wishlist

`GET /api/account/wishlist`

## Request

- Base URL: `https://api.getcheapgames.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getcheapgames.com/api/account/wishlist`
- Auth: none declared

Every item, newest first, each priced for its own market.

## Response `200`

Successful Response

- WishlistOut: `GET /api/account/wishlist`: every item, newest first.
  - `items` WishlistItemOut[], required
    - `id` integer, required
    - `game` GameCardOut, required: A game as a listing renders it. Declared rather than derived from `GameOut` so the wire shape of a listing is readable in one place. The fields a listing never fills — description, the edition family, package contents — are simply absent instead of being serialised as a screenful of nulls.
      - `slug` string, required
      - `title` string, required
      - `releaseYear` integer, nullable, required
      - `releaseDate` string, date, nullable
      - `publisher` string, required
      - `genres` string[], required
      - `steamAppId` integer, nullable
      - `coverBase` string, nullable
      - `priceHistory` integer[]
      - `kind` string
      - `isFree` boolean
      - `freeToKeep` boolean
      - `giveaway` GcgSchemasGiveawayOut: A giveaway on another store than Steam: what the claim button says and where it goes (`catalog.GIVEAWAY_ELSEWHERE`). Steam's own is the game's `free_to_keep`, whose link the client builds from the appid.
        - `platform` string, required
        - `claimUrl` string, nullable
        - `endsAt` string, date-time, nullable
      - `playUrl` string, nullable
      - `edition` string, nullable
      - `franchise` string, nullable
      - `offers` OfferCardOut[]
        - `store` StoreRefOut, required: The store fields a client needs to render an offer. Embedded in each offer rather than referenced by id: it removes a client-side join and a second request, and six short records across a response is nothing next to the round trip it saves.
          - `code` string, required
          - `name` string, required
          - `accent` string, required
          - `kind` string, required
        - `currency` string, required
        - `listPriceCents` integer, nullable, required
        - `feeCents` integer, required
        - `totalCents` integer, required
        - `platform` string, required
        - `inStock` boolean, required
    - `targetCents` integer, nullable, required
    - `currency` string, required
    - `country` string, required
    - `createdAt` string, date-time, required
    - `best` WishlistBestOut, required: The cheapest usable offer for the item (gcg/wishlist/pricing.py): in stock, keyed for a region covering the item's country, fees included, in the item's own currency. Never converted.
      - `totalCents` integer, required
      - `currency` string, required
      - `store` StoreRefOut, required: The store fields a client needs to render an offer. Embedded in each offer rather than referenced by id: it removes a client-side join and a second request, and six short records across a response is nothing next to the round trip it saves.
        - `code` string, required
        - `name` string, required
        - `accent` string, required
        - `kind` string, required
    - `reached` boolean, required

---

[API](https://skmtc.dev/getcheapgames/apis/getcheapgames-api.md) · [All operations](https://skmtc.dev/getcheapgames/apis/getcheapgames-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getcheapgames/apis/getcheapgames-api/revisions/57333a690301?raw)