SEC Blast API quickstart
On this page
Get a free key, make your first call, and read a filing's documents. Every route is under https://api.secblast.com/v3.
See a real answer first
No key needed: the console shows the answer the API gave for Apple (AAPL).
1. Get a free API key
The Free plan needs no card. Your first key is created when you sign up, and you manage keys under API keys.
The examples read the key from the environment variable SECBLAST_API_KEY:
export SECBLAST_API_KEY="your API key"2. Make your first call
List the five newest 8-K filings:
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings?form=8-K&limit=5'In Python, with requests:
import os
import requests
API = "https://api.secblast.com/v3"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['SECBLAST_API_KEY']}"
# The five newest 8-K filings, amendments included (the default order is filing_date, newest first).
r = session.get(f"{API}/filings", params={"form": "8-K", "limit": 5}, timeout=30)
r.raise_for_status()
page = r.json()
for filing in page["data"]:
print(filing["accession"], filing["filing_date"], filing["form_type"], filing.get("primary_name"))In TypeScript, with fetch:
const API = "https://api.secblast.com/v3";
const key = process.env.SECBLAST_API_KEY;
type Filing = { accession: string; filing_date: string; form_type: string; primary_name?: string | null };
type FilingList = { data: Filing[]; has_more: boolean; next_cursor: string | null };
const res = await fetch(`${API}/filings?form=8-K&limit=5`, {
headers: { Authorization: `Bearer ${key}` },
});
if (!res.ok) {
// Errors are RFC 9457 problem bodies with a stable `code` and a `request_id`.
const problem = await res.json();
throw new Error(`${problem.status} ${problem.code}: ${problem.detail} (request ${problem.request_id})`);
}
const page: FilingList = await res.json();
for (const filing of page.data) {
console.log(filing.accession, filing.filing_date, filing.form_type, filing.primary_name);
}With the Python SDK:
from secblast import SecBlastClient
client = SecBlastClient() # reads SECBLAST_API_KEY
page = client.list_filings(form="8-K", limit=5)
for filing in page["data"]:
print(filing["accession"], filing["filing_date"], filing["form_type"], filing.get("primary_name"))With the TypeScript SDK:
import { SecBlastClient } from '@secblast/sdk';
const client = new SecBlastClient(); // reads SECBLAST_API_KEY
const page = await client.listFilings({ form: '8-K', limit: 5 });
for (const filing of page.data) {
console.log(filing.accession, filing.filing_date, filing.form_type, filing.primary_name);
}The response, shortened:
{
"data": [
{
"accession": "0002057463-26-000023",
"form_type": "8-K",
"filing_date": "2026-10-09",
"items": ["7.01", "9.01"],
"primary_name": "Liberty Capital Corp/NV",
"doc_count": 13
},
{
"accession": "0001914496-26-000150",
"form_type": "8-K",
"filing_date": "2026-10-09",
"items": ["3.02", "7.01"],
"primary_name": "Sculptor Diversified Real Estate Income Trust, Inc.",
"doc_count": 11
}
],
"has_more": true,
"next_cursor": "eyJhIjoiMDAwMTkwMzU5Ni0yNi0wMD..."
}Each filing has its accession number, form type, filing date, 8-K items, and the company that filed it. has_more and next_cursor lead to the next page (Pagination).
3. Read a filing's documents
Pass a filing's accession to GET /v3/filings/{accession}/documents. It lists the filing's documents in order: the form itself, then its exhibits. Each has its sequence number, type, filename, description, and size.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001213900-26-109901/documents'from secblast import SecBlastClient
client = SecBlastClient() # reads SECBLAST_API_KEY
result = client.list_documents("0001213900-26-109901")
print(result)import { SecBlastClient } from '@secblast/sdk';
const client = new SecBlastClient(); // reads SECBLAST_API_KEY
const result = await client.listDocuments('0001213900-26-109901');
console.log(result);The response for an 8-K that announced a merger, shortened:
{
"data": [
{"seq":1,"type":"8-K","filename":"ea0308610-8k_varonis.htm","size_bytes":86059},
{
"seq": 2,
"type": "EX-2.1",
"filename": "ea030861001ex2-1.htm",
"description": "AGREEMENT AND PLAN OF MERGER, DATED AS OF OCTOBER 15, 2026, BY AND AMONG VARONIS SYSTEMS, INC., PROOFPOINT, INC. AND VAIL MERGER SUB, INC",
"size_bytes": 731411
},
{
"seq": 4,
"type": "EX-99.1",
"filename": "ea030861001ex99-1.htm",
"description": "PRESS RELEASE ISSUED BY PROOFPOINT, INC. AND VARONIS SYSTEMS, INC., DATED OCTOBER 15, 2026",
"size_bytes": 38421
}
]
}GET /v3/filings/{accession}/documents/{document} returns one document exactly as it was filed, by sequence number or filename, with its own content type, such as HTML, plain text, or PDF. Add /text to get the document as plain text. This call reads the press release, EX-99.1:
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001213900-26-109901/documents/4/text'from secblast import SecBlastClient
client = SecBlastClient() # reads SECBLAST_API_KEY
text = client.get_document_text("0001213900-26-109901", "4")
print(text)import { SecBlastClient } from '@secblast/sdk';
const client = new SecBlastClient(); // reads SECBLAST_API_KEY
const text = await client.getDocumentText('0001213900-26-109901', '4');
console.log(text);Exhibit 99.1
Proofpoint to Acquire Varonis in a $6.3 Billion Transaction
Combination creates a new cybersecurity powerhouse to deliver a complete security platform that protects against AI-accelerated threats and data risks
MIAMI, FL and SUNNYVALE, CA – October 15, 2026 – Varonis Systems, Inc. (Nasdaq: VRNS) (“Varonis”), the data and AI security leader, and Proofpoint, Inc. …Client libraries
Official clients for Python and TypeScript wrap every route. Python and TypeScript SDKs covers paging, errors, the stream, and webhooks.
Install secblast from PyPI, then list Apple's latest 10-K filings:
pip install secblastfrom secblast import SecBlastClient
client = SecBlastClient() # reads SECBLAST_API_KEY
page = client.list_filings(ticker="AAPL", form="10-K", limit=5)
for filing in page["data"]:
print(filing["accession"], filing["filing_date"])Install @secblast/sdk from npm, then list Apple's latest 10-K filings:
npm install @secblast/sdkimport { SecBlastClient } from '@secblast/sdk';
const client = new SecBlastClient(); // reads SECBLAST_API_KEY
const page = await client.listFilings({ ticker: 'AAPL', form: '10-K', limit: 5 });
for (const filing of page.data) console.log(filing.accession, filing.filing_date);Both clients:
- Send requests to
https://api.secblast.com/v3by default. - Read the key from
SECBLAST_API_KEY, or take it in the constructor. - Page through
next_cursorfor you. - Raise typed errors that carry the problem code, and retry a
429or503after itsRetry-Aftertime. - Download documents as bytes, text, or PDF.
- Check webhook signatures with
verify_webhook(Python) orverifyWebhook(TypeScript). - Follow
/v3/streamwith a stream iterator.
Next steps
- Learn the rules every route shares: API basics.
- Find the route for your data: API reference.
- Get new filings as they arrive: Filing stream or Webhooks.
- See complete tasks in Python: Examples.
- Ask about filings in Claude, ChatGPT, Cursor, or VS Code: MCP server.
- Look up an EDGAR word: SEC terms.
- Try any route in the browser: the console.
- Give these docs to a language model: llms.txt, llms-full.txt, or the Markdown copy of any page, at its address plus
.md.
Markdown version: /docs/overview.md