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
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
item | query | string | yes | An 8-K item code, e.g. 2.02. Required. | |
filed_from | query | date (YYYY-MM-DD) | no | filing_date >= this date (inclusive). | |
filed_to | query | date (YYYY-MM-DD) | no | filing_date <= this date (inclusive). | |
source | query | comma-separated list of string | no | header, body, both. | |
body_status | query | comma-separated list of string | no | heading, combined_heading, not_applicable, not_found. | |
mismatch_kind | query | comma-separated list of string | no | none, header_omits_901, differs. | |
form_type | query | comma-separated list of string | no | Exact form types, e.g. 8-K/A. | |
amendments | query | string | no | include | Whether to include amendments. One of: include, exclude, only. |
status | query | comma-separated list of string | no | Status(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. | |
cik | query | string | no | The filing's primary CIK, padded or unpadded. | |
min_confidence | query | string | no | Rule confidence at least this, a number from 0 to 1. | |
flag | query | comma-separated list of string | no | Rows carrying any of these item flags. | |
as_of | query | string | no | Inclusive: 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). | |
order | query | string | no | desc | By filing date. One of: desc, asc. |
limit | query | integer | no | 50 | Page size, 1..1000. |
cursor | query | string | no | Opaque cursor from a previous page's next_cursor; bound to the filters and order. |
Responses
| Status | Body | Description |
|---|---|---|
200 | EightKItemSearchList (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | Problem (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). |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a EightKItemSearchList object.
| Field | Type | Required | Description |
|---|---|---|---|
as_of | string | null | no | |
data | array of object | no | |
data[].filing | FilingRef | no | |
data[].item | EightKItem | no | |
data[].links | object | no | |
data[].mismatch_kind | string | no | |
has_more | boolean | no | |
item | string | no | |
next_cursor | string | null | no | |
snapshot | Snapshot | no |
Example request
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