Events
Catch up on events
GET
Every event for the calling app's subscribed tickers after a cursor, in publish order, up to 30 days back. Start without since, then pass back next_cursor each time.
apiKeyheader
AuthorizationBearer <token>since?stringOpaque cursor. Pass it back unchanged.
Length
1 <= lengthlimit?integerRange
1 <= value <= 1000Default
100A page of events in order
application/json- response
data*array<||||>next_cursor*stringPass as since next time. Advance only from this value.
Length
1 <= lengthhas_more*booleancurl -X GET 'https://api.newsfilter.dev/v1/events'Example Response
{ "data": [ { "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": { "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", "shortlisted": true }, "story_id": "st_01JC4ZQ8M6W7Y3T2K9P5R1N0BX" }, "story_version": 1 } } ], "next_cursor": "string", "has_more": true}