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

# Retrieve a 10-K

> Find a US 10-K and retrieve its filing sections, source document, and XBRL files.

## Find the filing

```bash theme={"dark"}
curl "https://corpus-api.onera.app/us/filings?ticker=AAPL&filing_type=10-K&limit=1" \
  --header "X-API-KEY: $CORPUS_API_KEY"
```

Keep the returned `accession_number`; it is the stable identity for every filing artifact.
Check `content_status` before requesting document bytes or parsed items. `available` means the
accession content is ready; `pending` means the historical backfill or parser is still working.

## Get selected sections

Use the accession for an exact filing read. This also works for historical and delisted issuers
that no longer have a ticker. Pass `item` to request one section, or omit it to return every
parsed section:

```bash theme={"dark"}
curl "https://corpus-api.onera.app/us/filings/items?accession_number=0000320193-25-000079&item=Item-1A" \
  --header "X-API-KEY: $CORPUS_API_KEY"
```

For discovery by company and report period, use the existing selector mode instead:

```bash theme={"dark"}
curl "https://corpus-api.onera.app/us/filings/items?ticker=AAPL&filing_type=10-K&year=2025" \
  --header "X-API-KEY: $CORPUS_API_KEY"
```

Accession mode derives the filing's ticker, CIK, form, and report year from stored SEC metadata.
A valid accession with no parsed sections returns `items: []`; it is not reported as a missing
filing. Every returned section retains its parser version and source offsets.

## Inspect source artifacts

Use the accession routes to retrieve normalized content, the accession manifest, or available XBRL files:

```text theme={"dark"}
/us/filings/{accession_number}/content
/us/filings/{accession_number}/index
/us/filings/{accession_number}/xbrl
```

The content response is unchanged whether the filing predates or follows the compact-storage
rollout. Corpus resolves immutable content-addressed storage server-side and verifies its SHA-256
and byte size; internal Blob pointers are never exposed.

Treat the accession, SEC URL, parser version, and source offsets as part of any saved research evidence.

<Warning>
  Historical accession content is still being backfilled newest-first. A content, manifest, XBRL,
  or filing-item request can return `503` with `Retry-After` while processing is incomplete. Retry
  after the indicated interval; do not treat a pending parse as a missing SEC filing.
</Warning>