---
title: "Dated records of what companies filed and what federal agencies and the Federal Reserve published"
method: GET
path: "/api/news"
tags: ["Context"]
---

# Dated records of what companies filed and what federal agencies and the Federal Reserve published

`GET /api/news`

## Request

- Base URL: `https://api.prereason.com`
- URL: `https://api.prereason.com/api/news`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Records PreReason stores, newest first, each with its source, its
date or time and a link: what companies filed (for the companies
PreReason covers: 8-K items in the USA, EDINET in Japan, DART in Korea)
and what federal agencies and the Federal Reserve published (the
Federal Register's trade actions and export controls, Treasury buyback
operations, the Federal Reserve's monetary policy releases). An answer
holding a source's records carries that source's required notice in
`notices`.
Name one company in `about` for its filings alone. Every answer names
the sources it read; it states records, not reasons.

A filed 8-K line names the filing's substantive items in PreReason's
fixed order of significance, at most three, with a count of the rest;
item 7.01 (Regulation FD disclosure) and item 9.01 (financial
statements and exhibits) are carriers, named only when a filing
carries nothing else.

Each record is in the window by the date it shows. A source that
dates by day prints that day with no clock time: EDGAR's own filing
date, DART's receipt date, the Federal Register's publication date and
Treasury's buyback operation date. EDINET's submission and the Fed's
release print their own clock.

The order: by the date each record shows, newest first; within one
date, the records that show a time first, newest first, then the
records dated by day alone; ties go by id.

Needs an API key on any plan, and each read counts as one call. A bad
date, kind or limit answers 400; a company PreReason does not cover
answers 404.

## Query parameters

- `about` string
- `kind` 'filed' | 'official'
- `since` string, date
- `until` string, date
- `as_of` string, date
- `limit` integer

## Response `200`

The records, the window and the sentence naming the sources read

- object
  - `about` object, nullable, required
  - `window` object, required
  - `records` object[], required
  - `coverage` string, required
  - `notices` string[]
  - `note` string
  - `not_read` string[]

## Other responses

- `400`: A bad date, kind or limit, a window over 92 days, or kind official with about
- `401`: Authentication required
- `404`: A company PreReason does not cover, or one whose filings this version does not read
- `503`: No source could be read

## Changes

- **2026-10-11** `addb3bf74ea9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/prereason/apis/prereason-api/changes/api/news/get.md)

---

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