---
title: "Get Weekly Briefing"
method: GET
path: "/api/briefing/weekly/{user_id}"
tags: ["Briefing"]
---

# Get Weekly Briefing

`GET /api/briefing/weekly/{user_id}`

## 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/briefing/weekly/{user_id}`
- Auth: HTTP bearer

Get the latest weekly briefing. Generates one if none exists for the current week.
Free tier users receive a 403 — weekly briefing is a paid feature.

## Path parameters

- `user_id` string, uuid, required

## Response `200`

Successful Response

- WeeklyBriefingResponse
  - `sections` BriefingSectionResponse[], required
    - `title` string, required
    - `content` string, required
  - `overall_score` integer, required
  - `score_breakdown` object, required
  - `generated_at` string, required

## 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)