Skip to content

GET /v3/events/8k/{item}

One 8-K item's structured events across filings, newest first (by filing date, then accession): one row per filing with its events of that item, each a list of fields {value, value_as_found, span, rule_id, rule confidence} read from the item's text; exhibit numbers joined to the filing's documents by type. Only items whose rules passed the release gate are produced (others: 404 not_covered). Deleted (SEC-withdrawn) filings are listed, marked deleted, unless status leaves them out. event_type, min_confidence and a status set without final need cik or filed_from and filed_to at most 366 days apart. as_of: only filings SEC had accepted by then (inclusive; a date is the whole UTC day).

API key: required. See Authentication.

Group: 8-K items

Parameters

NameInTypeRequiredDefaultDescription
itempathstringyesAn 8-K item code with structured events: 2.02 and 4.01 (produced); 4.02, 5.02, 5.07 (built, not produced).
filed_fromquerydate (YYYY-MM-DD)nofiling_date >= this date (inclusive).
filed_toquerydate (YYYY-MM-DD)nofiling_date <= this date (inclusive).
cikquerystringnoThe filing's primary CIK, padded or unpadded.
event_typequerycomma-separated list of stringnoFilings with an event of any of these types (earnings_release, results_disclosure, ...).
min_confidencequerystringnoThe first event's rule confidence at least this, a number from 0 to 1.
statusquerycomma-separated list of stringnoStatus(es) of the rows' filings: provisional, final, deleted, comma-separated (as GET /v3/filings). Default: every status, deleted (SEC-withdrawn) filings included, each row's filing status saying so; status=final,provisional leaves deleted filings out.
as_ofquerystringnoInclusive: YYYY-MM-DDTHH:MM:SSZ (UTC, through the end of that second), YYYY-MM-DDTHH:MM:SS.ffffffZ (exact, 1-6 fraction digits) or YYYY-MM-DD (the whole UTC day).
orderquerystringnodescBy filing date. One of: desc, asc.
limitqueryintegerno50Page size, 1..500.
cursorquerystringnoOpaque cursor from a previous page's next_cursor; bound to the filters (as_of included).

Responses

StatusBodyDescription
200EightKEventList (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (application/problem+json)Missing, invalid or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728).
404Problem (application/problem+json)Not found.
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a EightKEventList object.

FieldTypeRequiredDescription
accuracyobjectnoItems 1.01 and 2.01 only (served with a field list): served_fields_version, served_fields, event_type_served, holdout, holdout_filings, and per served field (and event_type when served) precision, recall, tp, fp, fn, n on the item's holdout (static). 1.01 serves event_type, cash_per_share, exchange_ratio, price_per_share; 2.01 serves cash_per_share, exchange_ratio, price_per_share, closing_date, with event_type transaction_completed.
as_ofstring | nullno
dataarray of objectno
data[].eventsarray of EightKEventno
data[].filingFilingRefno
data[].item_codestringno
data[].linksobjectno
has_morebooleanno
itemstringno
next_cursorstring | nullno
snapshotobjectno

Example request

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/events/8k/2.02'

Open this route in the console

More in 8-K items

Next: GET /v3/events/items

Markdown version: /docs/reference/get-events-8k-item.md