Events & Payloads

Event envelope

Every webhook request has the same top-level shape. The specifics of the filing live under data.

{
  "id": "evt_9f8c1e2a4b6d",
  "type": "filing.created",
  "api_version": "v1",
  "occurred_at": "2026-07-20T09:31:04Z",
  "data": {
    "...": "event-specific, see below"
  }
}

string

Unique event identifier, prefixed with evt_. Use it to de-duplicate: the same event can be delivered more than once.

type

string

The event type. One of filing.created or filing.enriched. This is also sent in the X-StockInsights-Event header.

api_version

string

The payload contract version. Currently v1. A breaking change to the payload shape bumps this value.

occurred_at

string

When the event occurred, as an ISO 8601 timestamp.

data

object

The event-specific body. Its fields depend on type — see below.

There are two event types on the wire — filing.created and filing.enriched — but you subscribe at a finer grain. When configuring a destination you pick from this catalog, and StockInsights only delivers the ones you select. The key is the identifier shown next to each toggle in the dashboard:

Key	Subscription	Delivered as	How to recognize it
`announcement.created`	Announcement created	`filing.created`	`data.document_type` is `announcement`
`announcement.summary_ready`	Announcement summary ready	`filing.enriched`	`data.enrichment_type` is `summary`
`quarterly-result.created`	Quarterly result created	`filing.created`	`data.document_type` is `quarterly-result`

Because several subscriptions map onto the same wire type, always branch on data.document_type (and data.enrichment_type for enriched events), not on type alone.

`filing.created`

Sent when a new filing is ingested — for example a new announcement or a newly published quarterly result.

{
  "id": "evt_9f8c1e2a4b6d",
  "type": "filing.created",
  "api_version": "v1",
  "occurred_at": "2026-07-20T09:31:04Z",
  "data": {
    "filing_id": "a1b2c3d4e5f6",
    "country": "IN",
    "document_type": "announcement",
    "company": {
      "id": "RELIANCE",
      "exchange": "NSE"
    },
    "published_date": "2026-07-20T09:30:00Z",
    "source_url": "https://www.bseindia.com/...",
    "url": "https://api.stockinsights.ai/v1/filings/a1b2c3d4e5f6",
    "period": {
      "year": 2026,
      "quarter": "Q1"
    }
  }
}

data.filing_id

string

Identifier of the filing. Pass it to the filings API to fetch the full record.

data.country

string

Market the filing belongs to. Currently always IN.

data.document_type

string

The kind of filing, e.g. announcement or quarterly-result.

data.company

object

The company the filing belongs to.

Show properties

string

Company identifier (ticker/symbol).

exchange

string

Exchange the company is listed on, e.g. NSE or BSE.

data.published_date

string

When the filing was published, as an ISO 8601 timestamp.

data.source_url

string

Link to the filing’s original source document on the exchange or company site. May be absent when no valid source link is available.

data.url

string

Canonical StockInsights API URL for the filing.

data.period

object

Reporting period, when applicable (e.g. for quarterly results). Contains year (integer) and/or quarter (string, e.g. "Q1"), and is omitted entirely when neither applies — as it is for most announcements.

`filing.enriched`

Sent when an AI enrichment for a filing becomes available — for example an announcement summary. Carries the same fields as filing.created, plus the enrichment itself.

{
  "id": "evt_7a2d5b9c1e3f",
  "type": "filing.enriched",
  "api_version": "v1",
  "occurred_at": "2026-07-20T09:33:12Z",
  "data": {
    "filing_id": "a1b2c3d4e5f6",
    "country": "IN",
    "document_type": "announcement",
    "company": {
      "id": "RELIANCE",
      "exchange": "NSE"
    },
    "published_date": "2026-07-20T09:30:00Z",
    "source_url": "https://www.bseindia.com/...",
    "url": "https://api.stockinsights.ai/v1/filings/a1b2c3d4e5f6",
    "enrichment_type": "summary",
    "enrichment": {
      "summary": "The board approved a dividend of ...",
      "category_id": 12,
      "category": "Dividend",
      "sub_category": "Interim dividend",
      "sentiment": "positive",
      "significance": true
    }
  }
}

data.enrichment_type

string

The kind of enrichment. Currently always summary.

data.enrichment

object

The enrichment content. Its shape depends on enrichment_type.

Show properties for enrichment_type: summary

summary

string

AI-generated summary of the announcement.

API Documentation

Webhooks

India Market Data

US Market Data

Sample Scripts

Event envelope

`filing.created`

`filing.enriched`

​Event envelope

​Event types vs. what you subscribe to

​filing.created

​filing.enriched

Event envelope

Event types vs. what you subscribe to

`filing.created`

`filing.enriched`