PRprereason
Context

Get one briefing by id

Changed on

Alias for GET /api/context?briefing={id}. Accepts the dotted ids the catalog returns, e.g. /api/briefings/macro.snapshot. A .md or .json suffix sets the format.

Requires an API key. Unlike the short URL aliases, this route is not x402-payable — free tier is free of charge, not keyless, so sign up for a key rather than paying per call.

get/api/briefings/{id}

Request

  • Base URL
    https://api.prereason.com
  • Auth
    • HTTP bearer
    • or API key in header X-API-Key

Path parameters

idstring required
Example:macro.snapshot

Briefing ID as returned by the catalog (dot-namespaced).

Query parameters

format'json' | 'markdown'

Response format (json or markdown). Default is markdown.

datestring

A past date, YYYY-MM-DD: the briefing as of the end of that day (UTC; a company's numbers at the end of the day in its own market), for the periods released by then. Each figure says when it was public, or that it may be a later revision PreReason holds in its place. For a period's latest figures, including later corrections, leave date out. Tier-gated access.

Response

Briefing context

Changes

  • cfe83f781312Revision changes
    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

  • 604bc1a6bcccRevision changes
    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security BearerAuth was added to the API