---
title: "Fetch the World Brief (daily, weekly or monthly)"
method: GET
path: "/api/v1/brief"
---

# Fetch the World Brief (daily, weekly or monthly)

`GET /api/v1/brief`

## Request

- Base URL: `https://offnadir-delta.com`
- URL: `https://offnadir-delta.com/api/v1/brief`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Free of token charges. Returns the persisted AI-synthesized world brief. period=daily (default) is open on every plan for the days inside the key owner's plan history window (the same window as the app's Reports); an earlier date returns 403. Weekly and monthly are opened by the key owner's plan (the same entitlement as the app's Reports) and return 403 otherwise. Counts in stats cover every event in the window.

## Query parameters

- `period` 'daily' | 'weekly' | 'monthly'
- `date` string, date

## Response `200`

The world brief for the requested (or latest) day or period.

- object
  - `status` string
  - `brief` object
  - `period` object: weekly / monthly only: type, start, end.
  - `available_periods` object[]: weekly / monthly only: recent published periods.
  - `freshness` object: daily only.
  - `quality` object
  - `changes_since_previous_brief` object: daily only.

## Other responses

- `400`: Error response with a stable machine-readable code.
- `401`: Error response with a stable machine-readable code.
- `403`: Error response with a stable machine-readable code.
- `404`: Error response with a stable machine-readable code.
- `429`: Error response with a stable machine-readable code.

---

[API](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api.md) · [All operations](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/revisions/5cf3f2bed5a2?raw)
