GET /v1/filings/{accession_number}

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/filings/0000000000-26-000001"

{
  "object": "filing",
  "accessionNumber": "0000000000-26-000001",
  "ticker": "EXAMPLE",
  "cik": "0000000000",
  "form": "10-K",
  "filingDate": "2026-02-20",
  "primaryDocument": "example-2025-10k.htm",
  "provenance": {
    "source": "example",
    "sourceLabel": "Illustrative response - not a live SEC filing",
    "accessionNumber": null,
    "filingUrl": "https://example.com/sec-filings/example-2025-10-k",
    "retrievedAt": "2026-02-20T00:00:00.000Z",
    "parserVersion": "example"
  },
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Get one SEC filing record by its accession number.

Audience: engineers and agents that need one reproducible filing manifest before reading or extraction.

Coverage and source scope

Retrieve the materialized manifest for one immutable SEC accession number, including filing identity and source provenance. Optional issuer and form values are resolution hints, not substitutes for the accession number. A not-found response should not be silently replaced with a different or latest filing.

Canonical metadata

accessionNumber
ticker
cik
form
filingDate
primaryDocument
provenance
requestId
traceparent

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/filings/0000000000-26-000001"

Example response

{
  "object": "filing",
  "accessionNumber": "0000000000-26-000001",
  "ticker": "EXAMPLE",
  "cik": "0000000000",
  "form": "10-K",
  "filingDate": "2026-02-20",
  "primaryDocument": "example-2025-10k.htm",
  "provenance": {
    "source": "example",
    "sourceLabel": "Illustrative response - not a live SEC filing",
    "accessionNumber": null,
    "filingUrl": "https://example.com/sec-filings/example-2025-10-k",
    "retrievedAt": "2026-02-20T00:00:00.000Z",
    "parserVersion": "example"
  },
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Accession coverage and provenance

An accession number identifies one SEC filing and is the stable handoff from filing search or latest filing. Optional ticker, CIK, and form are resolution hints; they do not replace the accession. submission_file_limit bounds older-coverage fallback. Preserve the returned provenance before rendering or extracting sections.

Errors

A 404 filing_not_found means the requested accession could not be resolved under the supplied constraints. Do not silently substitute the latest filing or a similarly named issuer.

Give this prompt to your agent

Failure posture

use accessionNumber as the immutable filing citation
retain provenance and requestId with downstream output
on 404, verify the accession and optional hints before widening coverage

GET /v1/filings GET /v1/filings/{accession_number}/download

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​Accession coverage and provenance

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

Accession coverage and provenance

Errors

Give this prompt to your agent

Failure posture