Webhooks v2 is not yet available in the dashboard. Until it is released, every
destination receives v1 payloads.
What v2 is
In v2, thedata 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 indata.
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.The event type, for example
quarterly-result.created. See
Events for the full list.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
- 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 asnull. - 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 noform_type. - The values have fixed formats. For example,
quarterisQ1toQ4,monthis the English name of the month, andpublished_dateis2026-07-13T08:45:00.000Z. Each event page lists the formats. - Link keys end in
_link, as in the API:pdf_link,html_link,source_link.company_page_urlis the API’s own name for the page of the filing on stockinsights.ai. - Webhook extras come after the API keys.
- 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.idis the StockInsights id of the announcement. The API’sidis the id that the exchange gave the announcement. The key name is the same, but the values are different. - Announcement
ai_insights. It isnullonannouncement.created, because the summary does not exist yet.announcement.summary.createdhas 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
.updatedevent. The webhook sends the numbers as extracted; the API rounds them to 2 decimals. company_page_urlisnullwhen 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.