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

# SEC Filings API

> SEC filings with company, ticker, CIK, form type, filed date and period of report. Search by company.

`POST /v1/data/sec/filings/run`

**Pricing:** $0.002 per filing ($2.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**company** `string` *required*

Company.

**formTypes** `string[]`

Which SEC forms to include. Pick one or more; any case works (10k, 10-K, sc13d). SC 13D and SC 13G also cover the newer SCHEDULE 13D/13G filings. Leave empty for all form types, amendments included.

Allowed values: `10-K` (10-K: Annual report), `10-Q` (10-Q: Quarterly report), `8-K` (8-K: Current report), `S-1` (S-1: IPO registration), `S-3` (S-3: Shelf registration), `S-4` (S-4: Merger or exchange registration), `S-8` (S-8: Employee stock plan registration), `424B` (424B: Prospectus (424B1 to 424B8)), `DEF 14A` (DEF 14A: Proxy statement), `DEFA14A` (DEFA14A: Additional proxy materials), `3` (3: Initial insider ownership), `4` (4: Insider trade), `5` (5: Annual insider ownership), `144` (144: Planned insider sale), `13F-HR` (13F-HR: Institutional holdings), `SC 13D` (SC 13D: Beneficial ownership, active (5%+)), `SC 13G` (SC 13G: Beneficial ownership, passive (5%+)), `20-F` (20-F: Foreign issuer annual report), `6-K` (6-K: Foreign issuer current report), `40-F` (40-F: Canadian issuer annual report), `11-K` (11-K: Employee plan annual report), `NT 10-K` (NT 10-K: Late annual report notice), `NT 10-Q` (NT 10-Q: Late quarterly report notice).

**includeAmendments** `boolean` (default: false)

Also return amended filings (10-K/A, 8-K/A, 4/A and so on) for the picked form types. Off by default; has no effect when Form Types is empty, since that already returns every form.

**dateFrom** `date`

Date From as a date (YYYY-MM-DD).

**dateTo** `date`

Date To as a date (YYYY-MM-DD).

**maxResults** `integer` (default: 100)

How many filings to return in total. Defaults to 100; use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/sec/filings/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "company": "AAPL",
    "formTypes": [
      "10-K"
    ],
    "maxResults": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/sec/filings/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "company": "AAPL",
    "formTypes": [
        "10-K"
    ],
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/sec/filings/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "company": "AAPL",
  "formTypes": [
    "10-K"
  ],
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one filing, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `accessionNumber` | Accession Number | text |
| `companyName` | Company Name | text |
| `ticker` | Ticker | text |
| `cik` | Cik | text |
| `formType` | Form Type | text |
| `filedDate` | Filed Date | date |
| `periodOfReport` | Period Of Report | date |
| `title` | Title | text |
| `documentUrl` | Document URL | url |
| `filingIndexUrl` | Filing Index URL | url |
| `isXbrl` | Is Xbrl | boolean |
| `isInlineXbrl` | Is Inline Xbrl | boolean |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "sec/filings",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "companyName": "Apple Inc.",
      "isXbrl": true,
      "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/",
      "accessionNumber": "0000320193-25-000079",
      "isInlineXbrl": true,
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
      "filedDate": "2025-10-31",
      "formType": "10-K",
      "ticker": "AAPL",
      "periodOfReport": "2025-09-27",
      "title": "10-K",
      "cik": "0000320193"
    }
  ]
}
```

## Related APIs

For the numbers inside 10-K and 10-Q filings use [`sec/financials-as-reported`](https://docs.mindcase.co/apis/sec/financials-as-reported); for Form 4 insider trades use [`sec/insider-trades`](https://docs.mindcase.co/apis/sec/insider-trades); for 13D/13G stakes use [`sec/beneficial-ownership`](https://docs.mindcase.co/apis/sec/beneficial-ownership).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.