C Corpus
CCorpus

Guides

Retrieve a 10-K

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

Find the filing

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

Pass item to request one section, or omit it to return every parsed section:

curl "https://corpus-api.onera.app/us/filings/items?ticker=AAPL&filing_type=10-K&year=2025&item=Item-1A" \
  --header "X-API-KEY: $CORPUS_API_KEY"

Inspect source artifacts

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

/us/filings/{accession_number}/content
/us/filings/{accession_number}/index
/us/filings/{accession_number}/xbrl

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

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.