Skip to main content
Webhooks v2 is not yet available in the dashboard. Until it is released, every destination receives v1 payloads.

What v2 is

In v2, the data of each event is the object that the StockInsights API returns for the same filing. The keys have the same names, the same order and the same value formats. Thus one parser reads both the API and the webhooks. The delivery and retries rules are the same in v1 and v2.

The envelope

Every v2 request has the same envelope. The envelope describes the event. The filing is in data.
string
The event id: evt_ and a UUID. It is also the webhook-id header. The same event can arrive more than once, so de-duplicate on this id.
string
The event type, for example quarterly-result.created. See Events for the full list.
string
Always v2.
string
When the event happened, as an ISO 8601 timestamp in UTC.
object
The API object of the filing. Its keys depend on type.
object
Only on an .updated event. It has the old value of each field of data that changed, in the same shape as data. A field that did not change is not in it.

The rules of data

  1. Every key is always sent. A key that has no value for this filing is null. The API leaves such a key out; the webhook sends it as null.
  2. A key that no filing of the event type has is left out. For example, an India filing has no cik, and a quarterly result has no form_type.
  3. The values have fixed formats. For example, quarter is Q1 to Q4, month is the English name of the month, and published_date is 2026-07-13T08:45:00.000Z. Each event page lists the formats.
  4. Link keys end in _link, as in the API: pdf_link, html_link, source_link. company_page_url is the API’s own name for the page of the filing on stockinsights.ai.
  5. Webhook extras come after the API keys.
  6. Values are frozen at event time. The webhook keeps the values of the moment that the event was made, for example the company name. The API shows the values of now.

Webhook extras

These keys are in the webhook only. The API does not have them.

Where the values differ from the API

The keys are the same. A few values can differ:
  • Announcement id. The webhook’s data.id is the StockInsights id of the announcement. The API’s id is the id that the exchange gave the announcement. The key name is the same, but the values are different.
  • Announcement ai_insights. It is null on announcement.created, because the summary does not exist yet. announcement.summary.created has it.
  • Financial statement numbers. The API reads the XBRL filing. The webhook reads the result PDF, which comes first, sometimes days before the XBRL. A later extraction can correct a number, with an .updated event. The webhook sends the numbers as extracted; the API rounds them to 2 decimals.
  • company_page_url is null when the filing has no page yet.

Events

All events

The event types, their subscription keys, and when each one is sent.

Authentication

Verify the Standard Webhooks signature of each request.

Documents

Quarterly results, investor presentations and earnings transcripts.

Announcements

New announcements and their AI summaries.

Financial statements

Income statement, balance sheet and cash flow from the result PDF.