Skip to main content
GET
Company 8-K events

Authorizations

X-API-KEY
string
header
default:pk_live_YOUR_KEY
required

Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....

Path Parameters

id
string
required

Ticker symbol (e.g. NVDA), numeric SEC CIK (zero-padding optional), or the platform key of a non-SEC issuer (e.g. XSAU000001 — the cik field of the company payload). A bare ticker always resolves to the SEC registrant.

Query Parameters

limit
integer

Rows per page, 1–500. Omitted = every matching row.

Required range: 1 <= x <= 500
offset
integer
default:0

Rows to skip: the previous reply's nextOffset. Default 0.

Required range: x >= 0
family
string

One or more event families, comma-separated: keeps items whose SEC item code defines the family (5.02 leadership, 2.02 earnings, 1.01 agreement, 2.01 mna, 5.07 governance_vote, …) or whose span-verified facts belong to it. dividend, buyback, guidance, stock_split and legal_regulatory have no item of their own and match only extracted facts. Values: dividend, stock_split, guidance, earnings, mna, debt_financing, equity_financing, buyback, restatement_non_reliance, cyber_incident, restructuring, impairment, leadership, governance_vote, agreement, legal_regulatory, listing_compliance, other.

query
string

2–200 characters, case-insensitive: item names and codes, and the headline, summary, quote and subject of the item's extracted facts.

from
string<date>

First filing date, YYYY-MM-DD.

to
string<date>

Last filing date, YYYY-MM-DD.

sort
enum<string>
default:newest

Filing-date order; undated rows sort last either way.

Available options:
newest,
oldest

Response

OK

Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls.

cik
string[]
events
object[]
total
integer
unfilteredTotal
integer
limit
integer
offset
integer
hasMore
boolean
nextOffset
integer
sort
string