> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stockinsights.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> The v2 event types, the key you subscribe with, and when each event is sent.

## Event types

Each v2 event has its own `type`, so you do not need to read `data` to know what
happened. You subscribe to each event with its **subscription key**, which the
dashboard shows next to each event. The key is the same as the type, except for
the announcement summary.

| Event type | Subscription key | Sent when | `data` has the keys of |
| - | - | - | - |
| [`announcement.created`](https://docs.stockinsights.ai/webhooks/v2/announcements/announcement-created) | `announcement.created` | A new announcement is stored | [Announcements API](https://docs.stockinsights.ai/api-reference/india_endpoints/announcements-tagged-feed.md) |
| [`announcement.summary.created`](https://docs.stockinsights.ai/webhooks/v2/announcements/announcement-summary-created) | `announcement.summary_ready` | The AI summary of an announcement is ready | [Announcements API](https://docs.stockinsights.ai/api-reference/india_endpoints/announcements-tagged-feed.md) |
| [`quarterly-result.created`](https://docs.stockinsights.ai/webhooks/v2/documents/quarterly-result-created) | `quarterly-result.created` | A new quarterly result is stored | [Filings API](https://docs.stockinsights.ai/api-reference/india_endpoints/filings-feed.md) |
| [`quarterly-result.income-statement.created`](https://docs.stockinsights.ai/webhooks/v2/financial-statements/income-statement-created) | same as the type | The income statement is first extracted from the result PDF | [Income statement API](https://docs.stockinsights.ai/api-reference/india_endpoints/income-statement.md) |
| [`quarterly-result.balance-sheet.created`](https://docs.stockinsights.ai/webhooks/v2/financial-statements/balance-sheet-created) | same as the type | The balance sheet is first extracted | [Balance sheet API](https://docs.stockinsights.ai/api-reference/india_endpoints/balance-sheet.md) |
| [`quarterly-result.cash-flow.created`](https://docs.stockinsights.ai/webhooks/v2/financial-statements/cash-flow-created) | same as the type | The cash flow statement is first extracted | [Cash flow API](https://docs.stockinsights.ai/api-reference/india_endpoints/cash-flow.md) |
| [`quarterly-result.income-statement.updated`](https://docs.stockinsights.ai/webhooks/v2/financial-statements/income-statement-updated) | same as the type | A later extraction gives other numbers | [Income statement API](https://docs.stockinsights.ai/api-reference/india_endpoints/income-statement.md) |
| [`quarterly-result.balance-sheet.updated`](https://docs.stockinsights.ai/webhooks/v2/financial-statements/balance-sheet-updated) | same as the type | A later extraction gives other numbers | [Balance sheet API](https://docs.stockinsights.ai/api-reference/india_endpoints/balance-sheet.md) |
| [`quarterly-result.cash-flow.updated`](https://docs.stockinsights.ai/webhooks/v2/financial-statements/cash-flow-updated) | same as the type | A later extraction gives other numbers | [Cash flow API](https://docs.stockinsights.ai/api-reference/india_endpoints/cash-flow.md) |
| [`earnings-transcript.created`](https://docs.stockinsights.ai/webhooks/v2/documents/earnings-transcript-created) | `earnings-transcript.created` | A new earnings call transcript is stored | [Filings API](https://docs.stockinsights.ai/api-reference/india_endpoints/filings-feed.md) |
| [`earnings-transcript.updated`](https://docs.stockinsights.ai/webhooks/v2/documents/earnings-transcript-updated) | `earnings-transcript.updated` | The official transcript or the call recording arrives later | [Filings API](https://docs.stockinsights.ai/api-reference/india_endpoints/filings-feed.md) |
| [`investor-presentation.created`](https://docs.stockinsights.ai/webhooks/v2/documents/investor-presentation-created) | `investor-presentation.created` | A new investor presentation is stored | [Filings API](https://docs.stockinsights.ai/api-reference/india_endpoints/filings-feed.md) |

All events are for India (`IN`) filings.

## The order of events

* `announcement.created` comes first. `announcement.summary.created` comes when
  the summary is ready.
* `quarterly-result.created` comes first. The statement events come when the
  extraction from the result PDF is done.
* Each statement event is sent on its own. If one statement fails our checks,
  the other statements are still sent. Thus an income statement can arrive
  without its balance sheet.
* Delivery is at least once, and the order between events is not certain. Use
  `occurred_at` and the ids in `data` to put events in order.

## Which filings send an event

* Earnings transcript and investor presentation events are for new filings. An
  event is sent only if the filing was published at most 7 days before the
  event. Older filings that arrive through a backfill or a correction send no
  event.
* An earnings transcript event is sent only for the transcript of a results
  call with a known year and quarter.
* Most companies report only the income statement in Q1 and Q3. The balance
  sheet and the cash flow statement usually come only in Q2 and Q4. A statement
  that the filing does not have sends no event.

## `.updated` events

An `.updated` event has the full new `data`, and `previous_attributes` with the
old value of each field that changed. A field that did not change is not in
`previous_attributes`.

```json theme={null}
{
  "type": "quarterly-result.income-statement.updated",
  "data": { "...": "the full new statement" },
  "previous_attributes": {
    "consolidated": { "financials": { "income": { "sales": 16.26 } } }
  }
}
```

* `earnings-transcript.updated` says what changed in `data.change`:
  `published_transcript_available` (the official transcript replaces our
  machine-made one) or `recording_attached` (the call recording arrived).
* A statement `.updated` event is sent once for each new version of the
  numbers. If a later extraction gives the same numbers, no event is sent.

## Event pages

> [card] [Documents](https://docs.stockinsights.ai/webhooks/v2/documents/quarterly-result-created.md)
>
> Quarterly results, presentations and transcripts.

> [card] [Announcements](https://docs.stockinsights.ai/webhooks/v2/announcements/announcement-created.md)
>
> Announcements and their summaries.

> [card] [Financial statements](https://docs.stockinsights.ai/webhooks/v2/financial-statements/overview.md)
>
> Income statement, balance sheet and cash flow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.