Skip to content

GET /v3/events/items

One 8-K item across filings, newest first (by filing date, then accession): the parsed union of header and body items, with which side named it. source, body_status, mismatch_kind, form_type, amendments, min_confidence and flag 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). min_confidence is refused when the server does not serve rule confidence.

API key: required. See Authentication.

Group: 8-K items

Parameters

NameInTypeRequiredDefaultDescription
itemquerystringyesAn 8-K item code, e.g. 2.02. Required.
filed_fromquerydate (YYYY-MM-DD)nofiling_date >= this date (inclusive).
filed_toquerydate (YYYY-MM-DD)nofiling_date <= this date (inclusive).
sourcequerycomma-separated list of stringnoheader, body, both.
body_statusquerycomma-separated list of stringnoheading, combined_heading, not_applicable, not_found.
mismatch_kindquerycomma-separated list of stringnonone, header_omits_901, differs.
form_typequerycomma-separated list of stringnoExact form types, e.g. 8-K/A.
amendmentsquerystringnoincludeWhether to include amendments. One of: include, exclude, only.
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.
cikquerystringnoThe filing's primary CIK, padded or unpadded.
min_confidencequerystringnoRule confidence at least this, a number from 0 to 1.
flagquerycomma-separated list of stringnoRows carrying any of these item flags.
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..1000.
cursorquerystringnoOpaque cursor from a previous page's next_cursor; bound to the filters and order.

Responses

StatusBodyDescription
200EightKItemSearchList (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).
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 EightKItemSearchList object.

FieldTypeRequiredDescription
as_ofstring | nullno
dataarray of objectno
data[].filingFilingRefno
data[].itemEightKItemno
data[].linksobjectno
data[].mismatch_kindstringno
has_morebooleanno
itemstringno
next_cursorstring | nullno
snapshotSnapshotno

Example request

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/events/items?item=2.02'

Open this route in the console

More in 8-K items

Previous: GET /v3/events/8k/{item} · Next: GET /v3/filings/{accession}/items

Markdown version: /docs/reference/get-events-items.md