Games endpoints — list and fetch games

The games endpoints expose the Nestri game catalogue. Use GET /games to retrieve every title in the authenticated user’s library, or use GET /games/:id to look up any game in the Nestri catalogue by its ID — even titles not yet in the user’s library. Each game record includes base metadata, categorisation, and all available image assets.

GET /games

List all games in the authenticated user’s library.

GET https://api.nestri.io/games

Request headers

Authorization

string

required

Bearer token in the format Bearer <your-jwt-token>.

Response

Returns a data array of Game objects.

data

Game[]

required

Hide Game fields

string

required

Steam App ID used as the game’s unique identifier. Example: "1809540".

slug

string

required

URL-friendly identifier for the game. Example: "nine-sols".

name

string

required

Official game title as listed on Steam. Example: "Nine Sols".

description

string | null

required

Full game description covering features, storyline, and gameplay. Example: "Nine Sols is a lore rich, hand-drawn 2D action-platformer...".

score

number

required

Aggregate user review score from Steam as a percentage of positive reviews. Example: 4.7.

releaseDate

string

required

ISO 8601 release date on Steam. Example: "2024-05-29T06:53:24.000Z".

primaryGenre

string | null

required

Main genre that best represents the game’s content. Example: "Action".

controllerSupport

string

required

Level of gamepad compatibility: full, partial, or unknown.

compatibility

string

required

Steam Deck / Proton compatibility rating: high, medium, low, or unknown.

links

string[] | null

required

Social and website links associated with the game. Example: ["https://example.com"].

size

object

required

Storage requirements in bytes.

Show Size fields

downloadSize

number

required

Compressed download size in bytes. Example: 7907568608 (≈ 7.91 GB).

sizeOnDisk

number

required

Installed size on disk in bytes. Example: 13176088178 (≈ 13.18 GB).

genres

Category[]

required

Primary genre classifications. Each item has slug and name.

Example

curl https://api.nestri.io/games \
  --header "Authorization: Bearer <your-jwt-token>"

GET /games/:id

Get a single game by its ID. The game does not need to be in the user’s library — this endpoint covers the full Nestri catalogue.

GET https://api.nestri.io/games/:id

Use this endpoint to display game details without requiring the user to own the title, for example on a storefront or discovery page.

Path parameters

string

required

The Steam App ID of the game to retrieve. Example: "1809540".

Request headers

Authorization

string

required

Bearer token in the format Bearer <your-jwt-token>.

Response

Returns a data object with the same Game field structure as the list endpoint above.

Example

curl https://api.nestri.io/games/1809540 \
  --header "Authorization: Bearer <your-jwt-token>"

Example response

{
  "data": {
    "id": "1809540",
    "slug": "nine-sols",
    "name": "Nine Sols",
    "description": "Nine Sols is a lore rich, hand-drawn 2D action-platformer...",
    "score": 4.7,
    "releaseDate": "2024-05-29T06:53:24.000Z",
    "primaryGenre": "Action",
    "controllerSupport": "full",
    "compatibility": "high",
    "links": ["https://example.com"],
    "size": {
      "downloadSize": 7907568608,
      "sizeOnDisk": 13176088178
    },
    "genres": [
      { "slug": "action", "name": "Action" },
      { "slug": "adventure", "name": "Adventure" }
    ],
    "tags": [
      { "slug": "metroidvania", "name": "Metroidvania" }
    ],
    "developers": [
      { "slug": "redcandlegames", "name": "RedCandleGames" }
    ],
    "publishers": [
      { "slug": "redcandlegames", "name": "RedCandleGames" }
    ],
    "categories": [
      { "slug": "partial-controller", "name": "Partial Controller" }
    ],
    "franchises": [],
    "screenshots": [ ... ],
    "boxArts": [ ... ],
    "posters": [ ... ],
    "banners": [ ... ],
    "heroArts": [ ... ],
    "backdrops": [ ... ],
    "logos": [ ... ],
    "icons": [ ... ]
  }
}

Error responses

Status	Code	Description
`400`	`INVALID_PARAMETER`	Request validation failed (e.g. missing `id`)
`404`	`RESOURCE_NOT_FOUND`	No game found with the given ID
`429`	—	Rate limit exceeded

Overview

Endpoints

Games endpoints — list and fetch games

GET /games

Request headers

Response

Example

GET /games/:id

Path parameters

Request headers

Response

Example

Example response

Error responses

Build docs developers (and LLMs) love

Overview

Endpoints

Documentation Index

​GET /games

​Request headers

​Response

​Example

​GET /games/:id

​Path parameters

​Request headers

​Response

​Example

​Example response

​Error responses

Build docs developers (and LLMs) love

GET /games

Request headers

Response

Example

GET /games/:id

Path parameters

Request headers

Response

Example

Example response

Error responses