Skip to content

SEC filing alerts and webhooks

Have new SEC filings sent to your server as they are published. Filter by form type, 8-K item, company, or a search query, or follow every filing change as a stream.

What you get

Webhooks
Create an HTTPS endpoint, then a subscription that says which filings to send. Each delivery is signed with your endpoint's secret, and you can retry one delivery or replay a time window.
Search subscriptions
A subscription holds the same parameters as full-text search, so it can match words as well as form types and 8-K items.
A stream to follow
GET /v3/stream returns every filing change after a cursor: new, updated, and corrected filings. When there are none, it waits up to 30 seconds.
Test before you rely on it
Send an endpoint one sample event, or preview what a subscription would have sent for filings of the last 7 days.

Example calls

Set SECBLAST_API_KEY to your key first.

Follow new 8-K filings with item 5.02 (changes of directors and officers), waiting up to 30 seconds for each batch:

Python · GET /v3/stream
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/stream",
    params={"forms": "8-K", "items": "5.02", "wait": "30", "limit": "10"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Or have the same filings sent to a webhook endpoint. Create the endpoint first with POST /v3/callbacks/endpoints and use its id:

Python · POST /v3/search/subscriptions
import os
import requests

r = requests.post(
    "https://api.secblast.com/v3/search/subscriptions",
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    json={
        "name": "Executive changes (8-K item 5.02)",
        "query": {
            "forms": "8-K",
            "items": "5.02",
        },
        "endpoint_id": "cbe_0123456789abcdef01234567",
    },
    timeout=30,
)
r.raise_for_status()
print(r.json())

In the API reference

Questions

Webhook or stream?
Use webhooks when SEC Blast should call your server. Use the stream when your program asks for new filings and keeps its own place with a cursor.
How do I check that an event came from SEC Blast?
Each event is signed with your endpoint's secret. Webhooks shows how to verify it.
What if my server is down?
Failed deliveries are tried again. You can retry one delivery, or replay an endpoint's failed deliveries from a window of up to 30 days.
Can I alert on a phrase?
Yes. A search subscription takes the same q as full-text search, for example going concern in 10-K filings.
Which plans include webhooks?
Not every plan includes webhooks or the stream. A request on a plan without them gets 403 with the code plan_required. The limits of each plan are on the fees page.

Make your first request

Create a key, then use it in the examples above. The fees page lists what each plan includes.