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

# SEC Filing Monitor API — Webhook Alerts and Polling

> Monitor SEC filings with webhook alerts, email notifications, and REST polling. Filter by form type, ticker, and query. Get started at secapi.ai/signup.

Get SEC filing alerts delivered to your application when a saved monitor finds new matching filings. SEC API supports signed webhook delivery for `monitor.match` events, customer-configured email notifications, and REST polling for latest filings.

## Capabilities

<CardGroup cols={2}>
  <Card title="Monitor alerts" icon="bell">
    Create monitors for forms, tickers, and keyword queries. Matching filings emit `monitor.match` delivery events.
  </Card>

  <Card title="Webhook callbacks" icon="plug">
    Register an endpoint subscribed to `monitor.match` and SEC API will POST signed delivery payloads with retry handling.
  </Card>

  <Card title="Email notifications" icon="mail">
    Send monitor matches to verified recipients with unsubscribe, bounce, complaint, and billing-pause state handled by SEC API.
  </Card>

  <Card title="Structured payloads" icon="code">
    Every event includes parsed metadata: accession number, form type, filer CIK, company name, filed date, and direct document URLs.
  </Card>
</CardGroup>

## Quick start

Create a webhook endpoint for monitor match events:

```bash theme={null}
curl -X POST -H "x-api-key: $SECAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationUrl": "https://yourapp.com/webhooks/sec",
    "description": "10-K and 10-Q monitor alerts",
    "subscribedEventTypes": ["monitor.match"]
  }' \
  "https://api.secapi.ai/v1/webhook_endpoints"
```

```json theme={null}
{
  "object": "webhook_endpoint",
  "id": "wh_abc123",
  "status": "pending_verification",
  "subscribedEventTypes": ["monitor.match"]
}
```

Create a monitor for 10-K and 10-Q filings. Email delivery is optional; webhook delivery comes from the org-level endpoint subscription above.

```bash theme={null}
curl -X POST -H "x-api-key: $SECAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "10-K and 10-Q filings",
    "query": "annual report OR quarterly report",
    "filters": { "forms": ["10-K", "10-Q"] },
    "delivery": {
      "type": "email",
      "config": { "to": "alerts@example.com" }
    }
  }' \
  "https://api.secapi.ai/v1/monitors"
```

Get the latest filings via polling (REST fallback):

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

## Use cases

### Earnings release monitoring

Detect 8-K filings with Item 2.02 (Results of Operations) as monitor matches are swept. Trigger downstream analysis pipelines or alert internal teams from a signed webhook.

### Compliance surveillance

Financial institutions can monitor filings from counterparties, portfolio companies, and regulated entities without polling EDGAR directly.

### AI-powered filing analysis

Pipe monitor match events into LLM workflows to generate summaries, risk assessments, or structured extractions when relevant filings arrive.

## API endpoints

| Endpoint                                               | Description                                     |
| ------------------------------------------------------ | ----------------------------------------------- |
| `POST /v1/monitors`                                    | Create a saved filing monitor                   |
| `GET /v1/monitors`                                     | List saved monitors                             |
| `GET /v1/monitors/:monitor_id/matches`                 | Preview recent monitor matches                  |
| `POST /v1/webhook_endpoints`                           | Register a webhook endpoint for delivery events |
| `GET /v1/webhook_endpoints`                            | List active webhooks                            |
| `POST /v1/webhook_endpoints/:webhook_id/test`          | Send a signed test event                        |
| `POST /v1/webhook_endpoints/:webhook_id/rotate_secret` | Rotate the HMAC signing secret                  |
| `GET /v1/webhook_endpoints/:webhook_id/deliveries`     | Inspect delivery history                        |
| `GET /v1/filings/latest`                               | Poll latest filings (REST fallback)             |

## Why SEC API for filing monitors

| Feature                      | SEC API | Raw EDGAR      | sec-api.io | Quiver Quant |
| ---------------------------- | ------- | -------------- | ---------- | ------------ |
| Saved filing monitors        | Yes     | No             | Limited    | Limited      |
| Webhook with HMAC signing    | Yes     | No             | Yes        | No           |
| Email notification lifecycle | Yes     | No             | Limited    | Limited      |
| Form type filtering          | Yes     | No             | Yes        | Limited      |
| Structured JSON payloads     | Yes     | No (raw index) | Yes        | Partial      |
| Python + JS SDKs             | Yes     | No             | No         | No           |

## Get started

<Card title="Get your API key" icon="key" href="/getting-started">
  Start monitoring SEC filings with 150 included API calls (one-time).
</Card>

* [Filing Search API](/seo/sec-filing-search-api)
* [API Reference](/api-reference)
* [Python SDK](/python-sdk)