---
title: "Fetch game(s) by platform id"
method: GET
path: "/v1/Games/ByPlatformID"
tags: ["Games"]
---

# Fetch game(s) by platform id

`GET /v1/Games/ByPlatformID`

Fetch all games for one or more platforms. Additional data can be requested via `fields` and `include` params.

## Query parameters

- `apikey` string, required
- `id` string, required
- `fields` string
- `include` string
- `page` integer

## Response `200`

result

- GamesByGameID
  - `code` integer, required
  - `status` string, required
  - `remaining_monthly_allowance` integer, required
  - `extra_allowance` integer, required
  - `allowance_refresh_timer` integer — Seconds until monthly allowance resets. null for private/unlimited keys.
  - `pages` object, required
    - `previous` string, nullable
    - `current` string
    - `next` string, nullable
  - `data` object, required
    - `count` integer, required
    - `games` Game[], required
      - `id` integer
      - `game_title` string
      - `release_date` string
      - `platform` integer
      - `region_id` integer, nullable
      - `country_id` integer, nullable
      - `players` integer, nullable
      - `overview` string, nullable
      - `last_updated` string
      - `rating` string, nullable
      - `coop` string, nullable
      - `youtube` string, nullable
      - `os` string, nullable
      - `processor` string, nullable
      - `ram` string, nullable
      - `hdd` string, nullable
      - `video` string, nullable
      - `sound` string, nullable
      - `developers` integer[]
      - `genres` integer[]
      - `publishers` integer[]
      - `alternates` string[]
  - `include` object
    - `boxart` object
      - `base_url` ImageBaseUrlMeta
        - `original` string
        - `small` string
        - `thumb` string
        - `cropped_center_thumb` string
        - `medium` string
        - `large` string
      - `data` object
    - `platform` object
      - `data` object

## Other responses

- `403` — bad API key or hit rate-limit cap
- `406` — missing or invalid id parameter

---

[API](https://skmtc.dev/thegamesdb/apis/thegamesdb-api.md) · [All operations](https://skmtc.dev/thegamesdb/apis/thegamesdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thegamesdb/thegamesdb-api/revisions/7eee8ee33cd6/schema)