Webhook events
article.shortlisted
An article passed the filter and was placed in a story. Signed with Standard Webhooks.
application/json- body
event_id*stringUnique per event and the same on every retry. Dedupe on it.
type*stringThe event type. Always article.shortlisted.
schema_version*numberVersion of the event shape. Always 1.
occurred_at*stringWhen it happened.
Format
date-timeorigin*Originlive for news as it arrives. Apps should not notify users for backfill events.
Value in
"live""backfill""reprocess"ticker*stringThe ticker it is about.
data*What changed, as a snapshot taken when the event was created.
Acknowledge fast; process later
Example Requests
POST/article.shortlisted
application/json
{ "event_id": "evt_01JC4ZQ8M6W7Y3T2K9P5R1N0BX", "type": "article.shortlisted", "schema_version": 1, "occurred_at": "2026-11-03T14:05:00Z", "origin": "live", "ticker": "ACME", "data": { "article": { "id": "art_01JC4ZQ8M6W7Y3T2K9P5R1N0BX", "title": "Acme raises full-year revenue guidance", "outlet": "Example Wire", "url": "https://news.example.com/acme-raises-guidance", "published_at": "2026-11-03T14:05:00Z", "ticker": "ACME", "site": "news.example.com", "teaser": "The company cited stronger orders from industrial customers.", "first_seen_at": "2026-11-03T14:05:00Z", "pipeline_status": "shortlisted", "judgement": { "shortlisted": true, "about_company": "primary", "article_type": "news", "new_fact": "Acme raised its full-year revenue guidance to $4.2 billion.", "fact_timing": "first_report", "criteria": [ "corporate_event" ], "reason": "First report of a guidance change from the company.", "judged_on": "body" }, "story_id": "st_01JC4ZQ8M6W7Y3T2K9P5R1N0BX" }, "story_version": 1 }}