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

# Fetch game(s) images by game(s) id

`GET /v1/Games/Images`

Fetch images for one or more games. Results can be filtered by image type.

## Query parameters

- `apikey` string, required
- `games_id` string, required
- `filter[type]` string
- `page` integer

## Response `200`

result

- GamesImages
  - `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
    - `base_url` ImageBaseUrlMeta, required
      - `original` string
      - `small` string
      - `thumb` string
      - `cropped_center_thumb` string
      - `medium` string
      - `large` string
    - `images` object, required

## Other responses

- `403` — bad API key or hit rate-limit cap
- `406` — missing or invalid games_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)