GET /v1/filings/latest/sections/{section_key}

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/filings/latest/sections/item_1a?ticker=AAPL&form=10-K&view=agent"

{
  "object": "section",
  "ticker": "EXAMPLE",
  "accessionNumber": "0000000000-26-000001",
  "key": "item_1a",
  "startOffset": 1200,
  "endOffset": 1840,
  "snippet": "Illustrative Item 1A risk-factor snippet.",
  "accession": "0000000000-26-000001",
  "section_key": "item_1a",
  "char_start": 0,
  "char_end": 42,
  "highlighted_snippet": "Illustrative **Item 1A** risk-factor snippet.",
  "source_url": "https://www.sec.gov/Archives/edgar/data/0000000/000000000026000001/example-2025-10k.htm",
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Extract a named section from an issuer’s latest selected filing.

Audience: engineers and agents extracting a known section from the latest selected filing.

Coverage and source scope

Retrieve one supported canonical filing section, such as item_1a, item_7, or item_8, from an issuer’s latest selected filing. Use the returned accession number and source URL as the citation identity. The endpoint defaults to a 10-K and a missing or unavailable section is not evidence that the issuer made no disclosure.

Canonical metadata

object
ticker
accessionNumber
key
snippet
accession
section_key
source_url
requestId

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/filings/latest/sections/item_1a?ticker=AAPL&form=10-K&view=agent"

Example response

{
  "object": "section",
  "ticker": "EXAMPLE",
  "accessionNumber": "0000000000-26-000001",
  "key": "item_1a",
  "startOffset": 1200,
  "endOffset": 1840,
  "snippet": "Illustrative Item 1A risk-factor snippet.",
  "accession": "0000000000-26-000001",
  "section_key": "item_1a",
  "char_start": 0,
  "char_end": 42,
  "highlighted_snippet": "Illustrative **Item 1A** risk-factor snippet.",
  "source_url": "https://www.sec.gov/Archives/edgar/data/0000000/000000000026000001/example-2025-10k.htm",
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Section selection and evidence

section_key must be a supported canonical key such as item_1a, item_7, or item_8; it is not a free-form heading lookup. The route defaults to 10-K. Preserve the content together with provenance and accession number, and use section search when the heading is unknown or the work begins with a concept.

Errors

Invalid mode/view or issuer filters are 400 request errors. A 502 section_lookup_failed can reflect unavailable rendering or section coverage; do not replace it with an invented excerpt.

Give this prompt to your agent

Failure posture

retain accessionNumber, section_key, source_url, and requestId with every excerpt
distinguish absent or unavailable coverage from an empty snippet
retry 502 section_lookup_failed with bounded backoff

GET /v1/filings/latest/risk-categories GET /v1/filings/pension-benefit-schedule

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​Section selection and evidence

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

Section selection and evidence

Errors

Give this prompt to your agent

Failure posture