Filing section by accession

Retrieve a supported canonical section from one explicitly selected SEC filing. The accession number fixes the source document; preserve it with the returned source URL and section key for a reproducible citation. A missing section or unresolved accession does not establish that the underlying disclosure is absent.

get/v1/filings/{accession_number}/sections/{section_key}

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/filings/{accession_number}/sections/{section_key}
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

accession_numberstring required

Immutable SEC accession number for the filing to inspect.

section_keystring required

Canonical filing section key, such as item_1a, item_7, or item_8; it is not arbitrary heading text.

Query parameters

tickerstring

Optional ticker hint.

cikstring

Optional CIK hint.

formstring

Optional SEC form hint.

submission_file_limitinteger

Bound on SEC submission files inspected while resolving older filing coverage.

mode'full' | 'compact'

Section body mode. compact caps contentMd; full returns the full extracted section body when available. Invalid values return invalid_section_mode with acceptedValues.

view'default' | 'compact' | 'agent'

Section response shape. compact is equivalent to mode=compact; agent returns citation fields and snippets without the full section body. Invalid values return invalid_query_parameter with acceptedValues.

Response

Extracted section for the requested accession. Default/full and compact modes return section content with provenance; view=agent returns citation fields and snippet metadata without contentMd.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.