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

# EDGAR Filing Search API

> Find SEC filing records by issuer, form, date, fiscal period, or accession number, then keep the source URL and accession with your result.

Use filing search when you need to find the SEC record before you read it. It returns filing manifests: the issuer, form, filing date, accession number, and SEC source URL that let you retrieve the same filing again.

For one issuer's newest filing, start with [latest filing](/api-reference/filings/get-v1-filings-latest). For a known accession, use [filing by accession](/api-reference/filings/get-v1-filings-accession-number). Use this endpoint when you need a filtered list.

## Find recent 10-K filings

```bash theme={null}
curl "https://api.secapi.ai/v1/filings?ticker=AAPL&form=10-K&limit=3&sort=filing_date_desc" \
  -H "x-api-key: $SECAPI_API_KEY"
```

The response is a cursor-paginated list. Keep `accessionNumber` and `filingUrl` with any downstream note or model output; they identify the SEC source behind the result.

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "accessionNumber": "0000320193-24-000123",
      "ticker": "AAPL",
      "form": "10-K",
      "filingDate": "2024-11-01",
      "filingUrl": "https://www.sec.gov/Archives/..."
    }
  ],
  "hasMore": true,
  "nextCursor": "3"
}
```

The fields available in the default view can be broader than this example. Use `view=agent` only when the [endpoint reference](/api-reference/filings/get-v1-filings) documents the smaller projection you need.

## Narrow the result set

```bash theme={null}
# A filing window for a company and form.
curl "https://api.secapi.ai/v1/filings?ticker=MSFT&form=10-Q&date_from=2023-01-01&date_to=2024-01-01&sort=filing_date_desc" \
  -H "x-api-key: $SECAPI_API_KEY"

# A specific fiscal year. Use `filing_year` when the filing year matters.
curl "https://api.secapi.ai/v1/filings?ticker=MSFT&form=10-K&filing_year=2024" \
  -H "x-api-key: $SECAPI_API_KEY"

# A known accession number.
curl "https://api.secapi.ai/v1/filings?accession_number=0000320193-24-000123" \
  -H "x-api-key: $SECAPI_API_KEY"
```

Use `date_from` and `date_to` in `YYYY-MM-DD` form. `sort` accepts `filing_date_desc` or `filing_date_asc`. The exact filter set, aliases, and limits are part of the [filings reference](/api-reference/filings/get-v1-filings), which is the contract to use in production.

## Continue through a list

Pass `nextCursor` from one response as `cursor` in the next request. Do not derive pages from a total count: the API returns `hasMore` and `nextCursor` so a client can stop when the result set is exhausted.

```bash theme={null}
curl "https://api.secapi.ai/v1/filings?ticker=AAPL&form=10-K&limit=3&cursor=3" \
  -H "x-api-key: $SECAPI_API_KEY"
```

## Choose the next request

* Need the newest filing of a form: [retrieve the latest filing](/api-reference/filings/get-v1-filings-latest).
* Need a named item from one filing: [extract a section](/api-reference/filings/get-v1-filings-accession-number-sections-section-key).
* Need passages that match a question: [search filing content](/products/search).
* Need a map of filing families and current section support: [filing types and exhibits](/filing-types-and-exhibits).

For product context, see the [filing-search API page](https://secapi.ai/apis/filing-search) or try the [sandbox](https://secapi.ai/sandbox).