GET /v1/get/games

Back to Docs Page

Raw markdown source view for LLM workflows.

---
title: GET /v1/get/games
description: Returns the supported game catalog in id/name format.
---

Base URL for this endpoint: `https://api.gamequery.dev`

## Request

```bash
curl "https://api.gamequery.dev/v1/get/games"
```

Authentication is not required.

## Success response

```json
[
  { "id": "minecraft", "name": "Minecraft" },
  { "id": "counterstrike16", "name": "Counter-Strike 1.6" }
]
```

## Operational details

- Response body is gzip-compressed.
- Catalog responses are served from a Redis cache with a 24-hour TTL.
- On cache miss, the API loads the games catalog from server-side JSON and refreshes the Redis cache.
- Use `id` values as `game_id` in `POST /v1/post/fetch` requests.

## Method constraints

- Only `GET` is supported.
- Other methods return `405` with:

```json
{
  "error": "GET_1",
  "message": "Method Not Allowed. Only GET requests are accepted."
}
```