# 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](https://www.secblast.com/docs/authentication).

**Group:** [8-K items](https://www.secblast.com/docs/reference#8-k-items)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `item` | path | string | yes |   | An 8-K item code with structured events: 2.02 and 4.01 (produced); 4.02, 5.02, 5.07 (built, not produced). |
| `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). |
| `cik` | query | string | no |   | The filing's primary CIK, padded or unpadded. |
| `event_type` | query | comma-separated list of string | no |   | Filings with an event of any of these types (earnings_release, results_disclosure, ...). |
| `min_confidence` | query | string | no |   | The first event's rule confidence at least this, a number from 0 to 1. |
| `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. |
| `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..500. |
| `cursor` | query | string | no |   | Opaque cursor from a previous page's next_cursor; bound to the filters (as_of included). |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [EightKEventList](https://www.secblast.com/docs/reference/schemas#schema-eightkeventlist) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-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). |
| `404` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [EightKEventList](https://www.secblast.com/docs/reference/schemas#schema-eightkeventlist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `accuracy` | object | no | Items 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_of` | string \| null | no |   |
| `data` | array of object | no |   |
| `data[].events` | array of [EightKEvent](https://www.secblast.com/docs/reference/schemas#schema-eightkevent) | no |   |
| `data[].filing` | [FilingRef](https://www.secblast.com/docs/reference/schemas#schema-filingref) | no |   |
| `data[].item_code` | string | no |   |
| `data[].links` | object | no |   |
| `has_more` | boolean | no |   |
| `item` | string | no |   |
| `next_cursor` | string \| null | no |   |
| `snapshot` | object | no |   |

## Example request

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

[Open this route in the console](https://www.secblast.com/console#get-v3-events-8k-item)

## More in 8-K items

Next: [`GET /v3/events/items`](https://www.secblast.com/docs/reference/get-events-items)
