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

```bash
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'
```

```json
{
  "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.

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/sections?section=background_of_the_merger&cik=1361113&limit=1'
```

```json
{
  "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.

```bash
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'
```

```json
{
  "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.

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

```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
    }
  ]
}
```

**5. Read the press release.** Document text is plain text.

```bash
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. …
```

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

```bash
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'
```

```json
{
  "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.

```bash
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'
```

```json
{
  "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.

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings/0001193125-26-458853/ownership'
```

```json
{
  "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](https://www.secblast.com/docs/webhooks).

```bash
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.*

```json
{
  "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](https://www.secblast.com/docs/stream).

*Built to the documented schema; no subscription existed to capture. The filing fields are real.*

```http
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.

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/events/8k/2.02?cik=1898496&limit=1'
```

```json
{
  "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.

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/companies/1898496/statements?kind=IS&limit=1'
```

```json
{
  "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.

```bash
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'
```

```json
{
  "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"}
  ]
}
```

