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

> Find SEC filing records by issuer, form, date, text, or accession number.

Find SEC filing records by issuer, form, date, text, or accession number.

<Info>
  Audience: engineers and agents building bounded filing-history or accession-first workflows.
</Info>

## Coverage and source scope

Search materialized SEC filing manifests for a bounded research or monitoring workflow. Filter by one issuer identifier, form, filing date, text, or a known accession number; results include filing identity and source links. Coverage and freshness reflect the returned records and provenance, not a promise of real-time or complete EDGAR history.

## Canonical metadata

* `data`
* `hasMore`
* `nextCursor`
* `requestId`

## 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?ticker=AAPL&form=10-K&limit=10&view=agent"
  ```
</RequestExample>

## Example response

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "object": "filing",
        "ticker": "EXAMPLE",
        "form": "10-K",
        "accessionNumber": "0000000000-26-000001",
        "filingDate": "2026-02-20",
        "title": "Example Issuer, Inc. 2025 Form 10-K",
        "filingUrl": "https://www.sec.gov/Archives/edgar/data/0000000/000000000026000001/example-2025-10k.htm"
      }
    ],
    "hasMore": false,
    "nextCursor": null,
    "requestId": "req_2ZK8Q1W9F4M6P7R3"
  }
  ```
</ResponseExample>

## History, pagination, and freshness

Use `accession_number` for one known filing; otherwise constrain broad searches with issuer, form, date, or text filters. `submission_file_limit` bounds fallback SEC-submission inspection for older coverage. Follow `nextCursor` while `hasMore` is true and retain `queryPath` and `policyYears` when explaining where the result came from. Read [filing and source conventions](/api-conventions) before comparing records across filing periods.

## Errors

Invalid filter combinations and pagination are contract-aware `400` errors. A search-path failure is returned as `502 filing_search_failed`; it is not an empty historical result.

## Give this prompt to your agent

<Prompt>
  Use SEC API GET /v1/filings to find SEC filing records by issuer, form, date, text, or accession number. Preserve `data`, `hasMore`, `nextCursor`, `requestId` 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

* preserve accessionNumber, filingDate, filingUrl, hasMore, nextCursor, and requestId
* use bounded retries for `502 filing_search_failed`
* treat an empty page as no match only after its filters are recorded