# SEC Filings (`sec.filings`)

Recent SEC EDGAR filings (10-K, 10-Q, 8-K, S-1, 13F, Form 4...) for a US-listed company, with document links.

- **Route:** `POST /v1/run/sec.filings`
- **Price:** $0.002 per request ($2.00 per 1,000) · `cost_usd` on every response
- **Source:** SEC EDGAR APIs (`sec`) · failover: no
- **Measured latency:** not enough calls measured yet
- **Heavy response:** no

## Input

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `ticker` | string, null | no | null | Ticker, e.g. AAPL |
| `cik` | integer, null | no | null | SEC CIK (instead of ticker) |
| `forms` | array | no |  | Filter, e.g. ['10-K','8-K'] |
| `limit` | integer | no | 20 |  |

## Output (`output` in the run envelope)

| Field | Meaning |
|---|---|
| `filings` | Form, dates, accession number and document URL. |
| `name` | Company name. |

## Example

```bash
curl -s -X POST https://getallapis.com/v1/run/sec.filings \
  -H "Authorization: Bearer $GETALLAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"AAPL","forms":["10-K","10-Q"],"limit":5}'
```

```python
from getallapis_client import Client
client = Client()  # reads GETALLAPIS_API_KEY
result = client.run('sec.filings', {'ticker': 'AAPL', 'forms': ['10-K', '10-Q'], 'limit': 5})
print(result['cost_usd'], result['output'])
```

```bash
getallapis run sec.filings '{"ticker":"AAPL","forms":["10-K","10-Q"],"limit":5}'
```

Quote first (free, validates input): `POST /v1/quote/sec.filings` with the same body.
