---
title: "List monthly reports"
method: GET
path: "/api/v1/monthlies"
---

# List monthly reports

`GET /api/v1/monthlies`

## Request

- Base URL: `https://bithot.news`
- URL: `https://bithot.news/api/v1/monthlies`
- Auth: none declared

Index of published monthly reports, newest first: month, its first and last day, headline and BITHOT link. A monthly is published on the 1st of each month at 10:30 Asia/Shanghai, compiled from the dailies dated in that month.

## Query parameters

- `limit` integer

## Headers

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

## Response `200`

OK

- MonthliesResponse
  - `schemaVersion` unknown, required
  - `count` integer, required
  - `items` MonthlyEntry[], required
    - `periodStart` string, date, nullable, required: First calendar day the issue covers (Asia/Shanghai).
    - `periodEnd` string, date, nullable, required: Last calendar day the issue covers (Asia/Shanghai).
    - `generatedAt` string, date-time, required
    - `headline` string, nullable, required: The issue's lead: its most important item's title, or once that item is withdrawn the next one still public (older issues may carry their own headline).
    - `links` object, required
      - `aihot` string, uri, required
    - `attribution` Attribution: Machine-readable BITHOT 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: Calendar month, e.g. 2026-09.

## Other responses

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

---

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