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

# GET /v1/filings/{accession_number}

> Get one SEC filing record by its accession number.

Get one SEC filing record by its accession number.

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

## 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

<RequestExample>
  ```bash theme={null}
  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"
  ```
</RequestExample>

## Example response

<ResponseExample>
  ```json theme={null}
  {
    "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"
  }
  ```
</ResponseExample>

## Accession coverage and provenance

An accession number identifies one SEC filing and is the stable handoff from [filing search](/api-reference/filings/get-v1-filings) or [latest filing](/api-reference/filings/get-v1-filings-latest). 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

<Prompt>
  Use SEC API GET /v1/filings/{accession_number} to get one SEC filing record by its accession number. Preserve `accessionNumber`, `ticker`, `cik`, `form`, `filingDate`, `primaryDocument`, `provenance`, `requestId`, `traceparent` in the output. Return a concise markdown summary plus the exact structured payload fields that a downstream engineer or agent should keep using this result.
</Prompt>

## 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
