Workflows
Three questions investors ask, answered with a few calls each. Every example is a real request, and every response is a real answer from November 16, 2026, trimmed to the fields that matter (values unedited). Two webhook examples are built to the documented schema, and they say so.
Merger arbitrage: the terms, the background and the announcement
The question. A target just signed a merger agreement. What is the price per share, who is the buyer, how did the deal come about, and what did the companies announce?
8-K Item 1.01 events → the proxy's section map → the section text → the 8-K's documents → the press release
1. Find the deal. Item 1.01 events with event_type=merger_acquisition give the counterparty and the price per share (or the exchange ratio for a stock deal), each field with a confidence. The accuracy block gives each field's measured precision and recall. To scan every company, drop cik and keep a filed_from and filed_to window of at most 366 days.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/events/8k/1.01?filed_from=2026-09-01&filed_to=2026-11-16&cik=1361113&event_type=merger_acquisition&min_confidence=0.8&limit=3'{
"data": [
{
"filing": {
"accession": "0001213900-26-109901",
"form_type": "8-K",
"filing_date": "2026-10-15",
"primary_cik": "0001361113",
"primary_name": "VARONIS SYSTEMS INC"
},
"item_code": "1.01",
"events": [
{
"event_type": "merger_acquisition",
"confidence": 0.85,
"fields": [
{"name":"counterparty","value":"Proofpoint, Inc.","confidence":0.8},
{"name":"cash_per_share","value":"49.75","confidence":0.85},
{"name":"price_per_share","value":"49.75","confidence":0.8}
]
}
],
"links": {"text":"/v3/filings/0001213900-26-109901/items/1.01/text"}
}
],
"has_more": false,
"next_cursor": null,
"accuracy": {"fields":{"cash_per_share":{"n":21,"precision":1,"recall":0.8571}}}
}2. Find the proxy's background section. The section map locates *Background of the Merger* in the DEFM14A, with its size and confidence.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/sections?section=background_of_the_merger&cik=1361113&limit=1'{
"data": [
{
"filing": {
"accession": "0001213900-26-120640",
"form_type": "DEFM14A",
"filing_date": "2026-11-16",
"primary_name": "VARONIS SYSTEMS INC",
"status": "provisional"
},
"family": "merger",
"section": {
"key": "background_of_the_merger",
"heading_text": "Background of the Merger",
"status": "ok",
"confidence": 0.95,
"text_bytes": 43231,
"block_count": 85
},
"links": {
"text": "/v3/filings/0001213900-26-120640/sections/background_of_the_merger/text"
}
}
],
"has_more": true,
"next_cursor": "eyJhIjoiMDAwMTIxMzkwMC0yNi0xMjA2NDAi…"
}3. Read it. Section text comes in pieces: pass next_offset back as offset for the next 500 bytes, or leave out length for the whole section.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001213900-26-120640/sections/background_of_the_merger/text?length=500'{
"accession": "0001213900-26-120640",
"section": "background_of_the_merger",
"heading_text": "Background of the Merger",
"text_offset": 0,
"text_bytes": 500,
"text_total_bytes": 43231,
"text_truncated": true,
"next_offset": 500,
"text": "Background of the Merger\nAs part of the Company’s ongoing consideration and evaluation of its long-term strategic goals and plans, the Company Board and the Company’s management have periodically reviewed, considered and assessed the Company’s operations and financial performance, …"
}4. List the 8-K's documents. The merger agreement is EX-2.1 and the press release is EX-99.1.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001213900-26-109901/documents'{
"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
}
]
}5. Read the press release. Document text is plain text.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001213900-26-109901/documents/4/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. …Insider-buying clusters
The question. Which companies had several insiders buying on the open market in the same week, and who bought?
open-market buys across all issuers → group by issuer → that issuer's buys → each Form 4 in full
1. Scan the window. Code P is an open-market purchase. Page through the window and group the rows by issuer.cik. Here seven Larimar Therapeutics insiders bought on November 11 and 12; three of their rows are shown.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/ownership/insiders/transactions?code=P&table=non_derivative&filed_from=2026-11-02&filed_to=2026-11-13&limit=500'{
"data": [
{
"issuer": {"cik":"0001374690","name":"Larimar Therapeutics, Inc."},
"owners": [{"name":"Hamilton Thomas Edward"}],
"shares": "70000",
"price": "2.6726",
"transaction_date": "2026-11-12",
"accession": "0001193125-26-459008"
},
{
"issuer": {"cik":"0001374690","name":"Larimar Therapeutics, Inc."},
"owners": [{"name":"BEN-MAIMON CAROLE"}],
"shares": "18050",
"price": "2.7675",
"transaction_date": "2026-11-11",
"accession": "0001193125-26-458853"
},
{
"issuer": {"cik":"0001374690","name":"Larimar Therapeutics, Inc."},
"owners": [{"name":"Celano Michael"}],
"shares": "18460",
"price": "2.7081",
"transaction_date": "2026-11-11",
"accession": "0001193125-26-458834"
}
],
"has_more": true,
"next_cursor": "…"
}2. Narrow to the issuer. The same query with issuer_cik returns only that company's buys.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/ownership/insiders/transactions?issuer_cik=1374690&code=P&filed_from=2026-11-02&filed_to=2026-11-13&limit=3'{
"view": "as_filed",
"data": [
{
"owners": [{"name":"Hamilton Thomas Edward"}],
"shares": "70000",
"price": "2.6726",
"transaction_date": "2026-11-12",
"accession": "0001193125-26-459008"
},
{
"owners": [{"name":"BEN-MAIMON CAROLE"}],
"shares": "18050",
"price": "2.7675",
"transaction_date": "2026-11-11",
"accession": "0001193125-26-458853"
},
{
"owners": [{"name":"THOMAS FRANK E"}],
"shares": "8000",
"price": "2.725",
"transaction_date": "2026-11-11",
"accession": "0001193125-26-458848"
}
],
"has_more": true,
"next_cursor": "eyJhIjoiMDAwMTE5MzEy…"
}3. Open a Form 4. The filing's ownership record names the owner and their role, every transaction and the footnotes.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings/0001193125-26-458853/ownership'{
"accession": "0001193125-26-458853",
"issuer": {"cik":"0001374690","name":"Larimar Therapeutics, Inc.","trading_symbol_raw":"LRMR"},
"filing": {"form_type":"4","filing_date":"2026-11-12","status":"final"},
"owners": [
{
"name": "BEN-MAIMON CAROLE",
"cik": "0001529611",
"relationship": {
"is_director": true,
"is_officer": true,
"is_ten_percent_owner": false,
"officer_title": "President and CEO"
}
}
],
"tables": {
"non_derivative_transactions": [
{
"transaction_code": "P",
"transaction_date": "2026-11-11",
"security_title": "Common Stock",
"shares": "18050",
"price": "2.7675",
"acquired_disposed": "A",
"shares_after": "386326",
"ownership_form": "D"
}
]
},
"footnotes": [
{
"id": "F2",
"text": "The price reported in Column 4 is a weighted average price. These shares were purchased in multiple transactions at prices ranging from $2.765 to $2.77, inclusive. …"
}
]
}Earnings monitoring
The question. When a company files its earnings release, what period does it cover, and how did revenue and EPS compare with last year and with peers?
a search subscription → a filing.new webhook → the 8-K Item 2.02 event → the income statement → peers from frames
1. Subscribe. A search subscription on 8-K filings with Item 2.02 sends each new one to your webhook endpoint. See Webhooks.
curl -sS -X POST -H "Authorization: Bearer $SECBLAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"8-K filings with Item 2.02","endpoint_id":"cbe_0123456789abcdef01234567","query":{"forms":"8-K","items":["2.02"]}}' \
'https://api.secblast.com/v3/search/subscriptions'*Built to the documented schema; no subscription existed to capture. The filing fields are real.*
{
"id": "sub_0123456789abcdef01234567",
"name": "8-K filings with Item 2.02",
"kind": "filing",
"endpoint_id": "cbe_0123456789abcdef01234567",
"include_corrections": false,
"min_interval_s": null,
"active": true,
"created_at": "2026-11-16T15:00:00Z"
}2. Receive the filing. Each matching filing arrives as a signed filing.new delivery. Without an endpoint, read the same filings from the stream.
*Built to the documented schema; no subscription existed to capture. The filing fields are real.*
POST <your endpoint>
Content-Type: application/json
webhook-id: str_000000000184467
webhook-timestamp: 1763333700
webhook-signature: v1,<signature>
X-SecBlast-Event: filing.new
{
"id": "str_000000000184467",
"type": "filing.new",
"schema_version": 1,
"test": false,
"subscription": {"id":"sub_0123456789abcdef01234567","name":"8-K filings with Item 2.02"},
"data": {
"filing": {
"accession": "0001628280-26-074189",
"form_type": "8-K",
"filing_date": "2026-11-16",
"items": ["2.02","9.01"],
"status": "provisional",
"accepted_at": "2026-11-16T21:12:33Z",
"entities": [{"cik":"0001898496","name":"Getty Images Holdings, Inc.","role":"filer"}],
"links": {"self":"/v3/filings/0001628280-26-074189"}
}
}
}3. Read the earnings event. The Item 2.02 event gives the period, the release date and the exhibit that holds the release.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/events/8k/2.02?cik=1898496&limit=1'{
"data": [
{
"filing": {
"accession": "0001628280-26-074189",
"form_type": "8-K",
"filing_date": "2026-11-16",
"primary_name": "Getty Images Holdings, Inc."
},
"item_code": "2.02",
"events": [
{
"event_type": "earnings_release",
"confidence": 0.9,
"exhibits": [
{
"doc_seq": 2,
"number": "99.1",
"type": "EX-99.1",
"url": "/v3/filings/0001628280-26-074189/documents/2"
}
],
"fields": [
{"name":"period_end","value":"2026-09-30","confidence":0.9},
{"name":"period_kind","value":"q3","confidence":0.9},
{"name":"release_date","value":"2026-11-16","confidence":0.9}
]
}
]
}
]
}4. Get the income statement. The latest 10-Q's income statement has the quarter and the same quarter a year earlier as columns. Getty Images' revenue fell from the year before, and diluted EPS turned negative.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/companies/1898496/statements?kind=IS&limit=1'{
"cik": "0001898496",
"data": [
{
"accession": "0001628280-26-074191",
"filing": {"form_type":"10-Q","filing_date":"2026-11-16","period_of_report":"2026-09-30"},
"statements": [
{
"columns": [
{"period":{"start":"2026-07-01","end":"2026-09-30"}},
{"period":{"start":"2025-07-01","end":"2025-09-30"}}
],
"rows": [
{
"concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
"label": "Revenue",
"cells": [{"value":"234029000"},{"value":"240044000"}]
},
{
"concept": "us-gaap:EarningsPerShareDiluted",
"label": "Diluted (in dollars per share)",
"cells": [{"value":"-1.34"},{"value":"0.05"}]
}
]
}
]
}
]
}5. Compare peers. A frame returns one concept for one period across every filer. It has no company filter, so pick the peers' CIKs from the rows: here Getty Images, Shutterstock, Yelp and Ziff Davis.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/financials/frames?concept=us-gaap%3ARevenueFromContractWithCustomerExcludingAssessedTax&period=2026-07-01%2F2026-09-30&unit=iso4217%3AUSD&limit=50000'{
"data": [
{"entity_cik":"0001898496","value":"234029000","unit_norm":"iso4217:USD"},
{"entity_cik":"0001549346","value":"173898000","unit_norm":"iso4217:USD"},
{"entity_cik":"0001345016","value":"370919000","unit_norm":"iso4217:USD"},
{"entity_cik":"0001084048","value":"289326000","unit_norm":"iso4217:USD"}
]
}Markdown version: /docs/workflows.md