Skip to main content

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, and meta.corrects may reference the corrected providerEventId.
  • 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 source and use entryId for ordering and resume.
  • eventType is an open taxonomy: new action types appear over time. Match the ones you support, ignore the rest.