> ## Documentation Index
> Fetch the complete documentation index at: https://docs.focusalpha.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Filing items

> The full text of a named part of a named SEC filing — Item 1A risk factors, Item 7 MD&A, or an 8-K event item.

`GET /v1/filings/items` splits a single SEC filing (10-K, 10-Q, or 8-K) into its constituent items with full text. Use it when you know **which document** you want — the risk factors of a specific 10-K, the MD\&A of a specific 10-Q, the items of a specific 8-K. When you want what a company *said* about a topic without naming a document, use [`POST /v1/retrieve`](/api-reference/retrieval) instead.

These routes return bare wrapper-key responses (no `meta` envelope) and use the flat `{ error, message }` error body — see [Errors](/concepts/errors). Unknown query parameters are silently ignored.

## GET /v1/filings/items

Returns one filing, split into items with text. The filing is identified by `ticker` + `filing_type` + `year` (plus `quarter` for a 10-Q, or `accession_number` for an 8-K).

**Plan:** Free and above · **Credits:** 1 per call — automatically refunded when the response carries no items because the document could not be parsed

<ParamField query="ticker" type="string" required>
  Trading symbol. Resolved to a CIK internally.
</ParamField>

<ParamField query="filing_type" type="string" required>
  One of `10-K`, `10-Q`, `8-K`. Only these three form schemas can be split into items.
</ParamField>

<ParamField query="year" type="integer" required>
  Calendar year of the filing's period of report.
</ParamField>

<ParamField query="quarter" type="integer">
  Quarter 1–4. **Required for 10-Q**; ignored for 10-K and 8-K.
</ParamField>

<ParamField query="accession_number" type="string">
  Filing accession number, with or without dashes. **Required for 8-K** — it selects the exact current report, since a company can file many 8-Ks in a year. Get it from [`GET /v1/filings`](/api-reference/filings).
</ParamField>

<ParamField query="item" type="string[]">
  Optional item-code filter, repeatable (`?item=Item-1A&item=Item-7`). Accepts `1A`, `item-1a`, `Item-1A`, or dotted 8-K codes like `2.02`. Omit to get every extracted item.
</ParamField>

<ParamField query="include_exhibits" type="boolean" default="false">
  When `true`, populate each owning item's `exhibits[]` with exhibit **metadata** (`number`, `description`, `url`). Body text is not fetched unless `include_exhibit_text` is also set.
</ParamField>

<ParamField query="include_exhibit_text" type="boolean" default="false">
  When `true` **and** `include_exhibits` is `true`, also fetch each exhibit's body `text`. Exhibit text is capped per exhibit, so a large investor presentation cannot blow up the response.
</ParamField>

<ParamField query="resolve" type="boolean" default="false">
  Selects the item-body resolution mode:

  * `false` (default, *literal*): each item's `text` is the body that physically sits under its SEC heading. A core item incorporated by reference (e.g. an Item 8 that reads "see Part IV, Item 15") returns its short pointer sentence.
  * `true` (*resolved*): by-reference core items are expanded to the full recovered body and carry `text_mode: "resolved"` plus a `resolved` provenance block. Recommended for LLM/RAG and audit pulls.
</ParamField>

```bash theme={null}
curl "https://api.focusalpha.ai/v1/filings/items?ticker=AAPL&filing_type=10-K&year=2025&item=Item-1A&resolve=true" \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"
```

```json theme={null}
{
  "resource": "filings/items",
  "ticker": "AAPL",
  "cik": 320193,
  "filing_type": "10-K",
  "accession_number": "0000320193-25-000123",
  "year": 2025,
  "items": [
    {
      "number": "Item-1A",
      "name": "Risk Factors",
      "text": "The Company's business, reputation, results of operations...",
      "text_mode": "literal",
      "exhibits": []
    }
  ]
}
```

### Response fields

Each entry in `items[]` carries:

* `number` — canonical item code: `Item-1A` (10-K/10-Q) or `Item-2.02` (8-K).
* `name` — the human section title.
* `text` — the stripped section text.
* `text_mode` — `"literal"` or `"resolved"` (always present).
* `resolved` — provenance block, present **only** when `text_mode` is `"resolved"`: `{ source: "in_document" | "annual_report_exhibit", resolved_from?, text_chars, truncated }`.
* `exhibits` — exhibit list (`{ number, description, url, text? }`); empty unless `include_exhibits` was set and this item owns exhibits.

For a 10-Q, the top level also carries `quarter`. When the filing was fetched but could not be split into items, the response is a `200` with an empty `items` array and `items_unavailable_reason: "unparseable_document"` — and the credit for the call is refunded.

<Note>
  In default (literal) mode, a by-reference item — most commonly Item 8 of a 10-K whose financial statements live in Part IV — returns its pointer sentence, not the financial statements. Pass `resolve=true` to expand it.
</Note>

### 8-K example

An 8-K is identified by its `accession_number`, since a company can file many current reports in one year. List the filings first, then fetch the one you want:

```bash theme={null}
# 1. Find the 8-K's accession number
curl "https://api.focusalpha.ai/v1/filings?ticker=AAPL&filing_type=8-K&limit=1" \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"

# 2. Fetch its items (optionally with press-release exhibit text)
curl "https://api.focusalpha.ai/v1/filings/items?ticker=AAPL&filing_type=8-K&year=2026&accession_number=0000320193-26-000045&include_exhibits=true&include_exhibit_text=true" \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"
```

```json theme={null}
{
  "resource": "filings/items",
  "ticker": "AAPL",
  "cik": 320193,
  "filing_type": "8-K",
  "accession_number": "0000320193-26-000045",
  "year": 2026,
  "items": [
    {
      "number": "Item-2.02",
      "name": "Results of Operations and Financial Condition",
      "text": "On May 1, 2026, Apple Inc. issued a press release regarding its financial results...",
      "text_mode": "literal",
      "exhibits": [
        {
          "number": "EX-99.1",
          "description": "Press release issued by Apple Inc.",
          "url": "https://www.sec.gov/Archives/edgar/data/320193/...",
          "text": "Apple today announced financial results for its fiscal 2026 second quarter..."
        }
      ]
    }
  ]
}
```

<Warning>
  `include_exhibit_text=true` has no effect without `include_exhibits=true`. Exhibit text is truncated at a per-exhibit byte cap when very large.
</Warning>

## GET /v1/filings/items/types

Reference map of the item codes each supported form type can contain — item numbers and their standard titles for 10-K, 10-Q, and 8-K. Use it to know which `item` values are meaningful before filtering.

**Plan:** Free and above · **Credits:** free (not metered)

```bash theme={null}
curl https://api.focusalpha.ai/v1/filings/items/types \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"
```

The response is a map keyed by form type; each entry lists the item codes defined for that form with their standard names (for example `Item-1A` → "Risk Factors" under `10-K`, `Item-2.02` → "Results of Operations and Financial Condition" under `8-K`).