What it streams
An append-only log of in-play actions for fixtures: goals, cards, corners, substitutions, penalties, VAR decisions, dangerous attacks, and more. Events feed timeline and coverage products; for grading/settlement use the resolved stats and settlement endpoints instead.Routing
- Entity key:
payload.fixtureId - Filters:
sportIds,tournamentIds,fixtureIds - Access: live/pregame access is determined by your
apiKey
Payload structure
Each message carries one or more event rows in the canonical event model:Semantics
- Append-only. Events are never updated or deleted. A correction is itself an event — e.g. a VAR overturn arrives as its own
eventType, andmeta.correctsmay reference the correctedproviderEventId. - Dedup on
(fixtureId, source, providerEventId). Replays and reconnects can redeliver events; this key is idempotent. - One authoritative source per sport. There is no cross-source merging of events — filter by
sourceand useentryIdfor ordering and resume. eventTypeis an open taxonomy: new action types appear over time. Match the ones you support, ignore the rest.