Context

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

Changed on

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.

get/api/news

Request

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

Query parameters

aboutstring

One company, by its address (a ticker, CIK, securities code, stock code, ISIN or LEI). Left out, records of every company and agency read.

kind'filed' | 'official'

filed (company filings) or official (federal agency and Federal Reserve documents). Both when left out.

sincestring date

The first date of the window, YYYY-MM-DD. Seven days before until when left out.

untilstring date

The last date of the window, YYYY-MM-DD. Today (UTC) when left out.

as_ofstring date

Only records dated on or before this date, YYYY-MM-DD; in place of until.

limitinteger

Records one read returns, 1 to 25. Default 10.

Response

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

aboutobject nullable required
windowobject required
recordsobject[] required
coveragestring required
noticesstring[]
notestring
not_readstring[]

Changes