---
title: "Get a monthly report by month"
method: GET
path: "/api/v1/monthlies/{month}"
---

# Get a monthly report by month

`GET /api/v1/monthlies/{month}`

## Request

- Base URL: `https://gameshot.games`
- URL: `https://gameshot.games/api/v1/monthlies/{month}`
- Auth: none declared

A single monthly report by calendar month (YYYY-MM, for example 2026-09). Withdrawn citations are removed from later responses. Respect Cache-Control and revalidate with If-None-Match before reusing an expired copy.

## Path parameters

- `month` string, required

## Headers

- `User-Agent` string
- `If-None-Match` string

## Response `200`

OK

- MonthlyResponse
  - `schemaVersion` unknown, required
  - `report` MonthlyReport, required
    - `periodStart` string, date, nullable, required
    - `periodEnd` string, date, nullable, required
    - `generatedAt` string, date-time, required
    - `windowStart` string, date-time, required: Start of the dailies' windows the issue was compiled from.
    - `windowEnd` string, date-time, required
    - `links` object, required
      - `aihot` string, uri, required
    - `attribution` Attribution: Machine-readable Gameshot provenance for traceability. Retain it where technically feasible. Attribution alone is not authorization; see the public terms.
      - `name` string, required
      - `url` string, uri, required
    - `headline` string, nullable, required: The most important item's title, or once that item is withdrawn the next one still public (older issues may carry their own headline).
    - `overview` string, nullable, required: A short overview of the period's main threads, written only from the items listed.
    - `sections` object[], required: Sections in reading order, each with its items in order of importance. Withdrawn items are left out.
      - `label` string, required
      - `summary` string, nullable, required: One or two sentences introducing the section, when there is one.
      - `items` object[], required
        - `title` string, required
        - `summary` string, required
        - `source` object, required
          - `name` string, required
        - `links` DailyContentLinks, required
          - `aihot` string, uri, nullable, required
          - `original` string, uri, required
        - `publishedAt` string, date-time, nullable, required
        - `attribution` Attribution: Machine-readable Gameshot provenance for traceability. Retain it where technically feasible. Attribution alone is not authorization; see the public terms.
          - `name` string, required
          - `url` string, uri, required
    - `month` string, required

## Other responses

- `304`: Not Modified
- `400`: Machine-readable problem response.
- `403`: Machine-readable problem response.
- `404`: Machine-readable problem response.
- `405`: Machine-readable problem response.
- `429`: Machine-readable problem response.
- `503`: Machine-readable problem response.

---

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