---
title: "Get Monthly Recap"
method: GET
path: "/api/recap/monthly"
tags: ["Recap"]
---

# Get Monthly Recap

`GET /api/recap/monthly`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/recap/monthly`
- Auth: HTTP bearer

Generate or retrieve the monthly recap for the given month.

## Query parameters

- `month` string, required: Month in YYYY-MM format, e.g. 2026-02

## Response `200`

Successful Response

- RecapResponse
  - `id` string, nullable, required
  - `month` string, nullable, required
  - `sections` object[], required
  - `grade` string, nullable, required
  - `generated_at` string, nullable, required
  - `available` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)