FootballMatchEvent

Object type

A single in-match event (goal, card, substitution, …). Backed by football_match_events; idempotent on (provider, externalEventId).

Fields

Field	Args	Type	Description
id	—	ID! required	—
match	—	FootballMatch! required	—
participation	—	FootballMatchParticipation	—
player	—	Individual	The Individual the event is attributed to, where applicable.
relatedPlayer	—	Individual	Secondary individual (assist provider, substitution target, …).
eventType	—	FootballMatchEventType! required	—
eventSubtype	—	String	—
minute	—	Int	Match minute; null for minute-less events (e.g. pre-kickoff VAR check). Sorts last.
second	—	Int	—
addedMinute	—	Int	—
periodId	—	Int	Period/half the event occurred in: 1 first half, 2 second half, 3/4 extra time, 5 penalties; null if unknown. Lets events be grouped by half without inferring from minute.
xCoord	—	Float	—
yCoord	—	Float	—
onTarget	—	Boolean	—
supersededBy	—	FootballMatchEvent	Replacement event when this one was corrected (provider restatement).
supersedes	—	FootballMatchEvent	The event this one replaced.
isDeleted	—	Boolean! required	—
qualifiers	—	JSON	—
version	—	Int! required	Optimistic-locking version counter — increments on every write. Pass back as updateMatchEvent’s expectedVersion.
createdAt	—	DateTime! required	—
updatedAt	—	DateTime! required	—