GET /v1/filings - SEC API for AI

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"

{
  "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"
}

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

Audience: engineers and agents building bounded filing-history or accession-first workflows.

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

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"

Example response

{
  "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"
}

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

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

Filings GET /v1/filings/{accession_number}

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​History, pagination, and freshness

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

History, pagination, and freshness

Errors

Give this prompt to your agent

Failure posture