Events & Payloads - stockinsights.ai APIs

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.

string

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

string

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

string

When the event occurred, as an ISO 8601 timestamp.

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"
    }
  }
}

string

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

string

Market the filing belongs to. Currently always IN.

string

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

object

The company the filing belongs to.

Show properties

string

Company identifier (ticker/symbol).

string

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

string

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

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.

string

Canonical StockInsights API URL for the filing.

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

string

The kind of enrichment. Currently always summary.

object

The enrichment content. Its shape depends on enrichment_type.

Show properties for enrichment_type: summary

string

AI-generated summary of the announcement.

string

Announcement category name, e.g. Dividend. May be null.

integer

Numeric id of the category. May be null.

string

Finer-grained classification within the category. May be null.

string

Sentiment read from the announcement, e.g. positive. May be null.

boolean

Whether the announcement is considered materially significant. May be null.

All other data.* fields match filing.created.

​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`