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

# SEC Filings Search

> Search SEC EDGAR filings for a company by ticker and form type.

Find a company’s SEC filings by ticker symbol.
Covers annual reports (10-K, 20-F) and interim reports (10-Q, 6-K). Each result carries
the accession number, form type, filing date, company name, document URL, and the fiscal
year, fiscal period, and period-end date when available.
Use the returned fiscal year and period with sec\_filing\_fetch to pull narrative
sections.

**Endpoint:** `POST /api/v1/sec/search`

**Tier:** point · **Delivery:** sync

## Request

| Field       | Type                                           |
| ----------- | ---------------------------------------------- |
| `ticker`    | `string`                                       |
| `form_type` | `"10-K" \| "10-Q" \| "20-F" \| "6-K" \| "all"` |
| `from_date` | `string`                                       |
| `limit`     | `number`                                       |

## Response

The response is the two-key envelope `{ finterm, data }`, where `data` is the `finterm.result:SecFilingsSearch/v1` contract:

| Field           | Description                                                                                                                                                                                    |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `total_results` | Total number of matching filings (may exceed the number returned).                                                                                                                             |
| `filings`       | The matching filings, most recent first. Each carries the accession number, form type, filing date, company name, document URL, and the fiscal year/period and period-end date when available. |

## Example

```bash theme={"system"}
finterm tool sec_filings_search AAPL --form-type 10-K --as-of-date 2024-12-31
```