Skip to content
Searches page titles, headings, and route paths. Press slash to focus.

SEC Blast API quickstart

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:

Shell
export SECBLAST_API_KEY="your API key"

2. Make your first call

List the five newest 8-K filings:

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings?form=8-K&limit=5'

The response, shortened:

JSON
{
  "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.

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings/0001213900-26-109901/documents'

The response for an 8-K that announced a merger, shortened:

JSON
{
  "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:

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings/0001213900-26-109901/documents/4/text'
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:

Shell
pip install secblast
Python
from 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"])

Both clients:

  • Send requests to https://api.secblast.com/v3 by default.
  • Read the key from SECBLAST_API_KEY, or take it in the constructor.
  • Page through next_cursor for you.
  • Raise typed errors that carry the problem code, and retry a 429 or 503 after its Retry-After time.
  • Download documents as bytes, text, or PDF.
  • Check webhook signatures with verify_webhook (Python) or verifyWebhook (TypeScript).
  • Follow /v3/stream with a stream iterator.

Next steps

Markdown version: /docs/overview.md