---
title: "Get latest ranked brief"
method: GET
path: "/api/v1/briefs/{slug}"
---

# Get latest ranked brief

`GET /api/v1/briefs/{slug}`

## Request

- Base URL: `https://dirtsignal.com`
- URL: `https://dirtsignal.com/api/v1/briefs/{slug}`
- Auth: HTTP bearer

Returns the latest stored ranked brief for a region. Briefs are pre-composed and include ranked top picks, summary copy, generated window metadata, and event snapshots when available. Requires a paid account and an API key from Settings.

## Path parameters

- `slug` string, required

## Query parameters

- `window` 'weekly' | 'daily'

## Response `200`

Stored ranked brief

- BriefResponse
  - `region` object
    - `slug` string
    - `display_name` string
    - `timezone` string
  - `generated_for` string
  - `generated_at` string, date-time
  - `model` string
  - `window_kind` 'weekly' | 'daily'
  - `payload` BriefPayload
    - `local_lede` string
    - `summary` string
    - `coverage_update` string
    - `top_picks` BriefPick[]
      - `source_local_id` string
      - `rank` integer
      - `why_it_matters` string
      - `event_snapshot` object
        - `address_key` string, nullable
        - `address_raw` string, nullable
        - `event_subtype` string, nullable
        - `status` string, nullable
        - `source_url` string, nullable
        - `owner_name` string, nullable
    - `stats` object
      - `region_slug` string
      - `total_events` integer
      - `window_since` string, date-time
      - `window_until` string, date-time
      - `generated_at` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `403`: Paid account required
- `404`: Unknown region or no stored brief for the selected window

---

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