Football Match Events V1 (old)

Feed Match Event

Example Ably LiveAccess URL: https://platform.matchstate.api.geniussports.com/api/v1/sources/GeniusSportsInPlay/sports/10/fixtures/10489892/liveaccess/matchevents
Example PullAPI URL: https://platform.matchstate.api.geniussports.com/api/v1/sources/GeniusSportsInPlay/sports/10/fixtures/10489892/matchevents

{ "sportId": 10, "fixtureId": "9280712", "source": "GeniusSports", "sequenceId": 433, "actionId": 291, "isCancelled": false, "isConfirmed": true, "isModified": false, }

Element

Type

Description

sportId

integer

Sport identifier (10 for Football)

fixtureId

string

Fixture identifier

source

string

Feed provider identifier

sequenceId

integer

Fixture specific sequence identifier of the match event

actionId

integer

Match action identifier

isCancelled

boolean

Indicates whether the action is cancelled

isConfirmed

boolean

Indicates whether the action is confirmed

isModified

boolean

Indicates whether the action is modified

action

{}

Consists of Match Action data properties

messageTimestampUtc

string($date-time)

Timestamp of the message

Every Match Event has a type inside the “action” field, named after the respective Action. Example for KickOff below, where “KickOff” is replaced for different Actions.

"action": { "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.KickOffDto, Betgenius.Sports.Football.Contracts.MatchEvents"

Feed Match Action

NOTE: All Actions inside Feed Match Event include the following additional fields (hence they are not included in the description of every action).

"action": { "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CommentDto, Betgenius.Sports.Football.Contracts.MatchEvents", "team": "Away", "gameTime": "00:39:47", "period": { "number": 1, "progressStatus": "InProgress", "type": "Regular" }, "utcTimestamp": "2022-06-01T00:00:05.35Z" }

Element

Type

Description

team

string($x-extensible-enum)

[ None, Home, Away ]

Team data

gameTime

string($date-span)

Game time data

period

{}

Period in the game data

utcTimestamp

string($date-time)

Timestamp of the message

number

integer($int32)

Period number
Values: 1, 2

progressStatus

string($x-extensible-enum)

[ NotStarted, InProgress, Complete]

Period progress status

type

string($date-span)

Game time data
Period.Type values: Regular/ExtraTime/PenaltyShootout

Actions 

NOTE: All Feed Match Actions consist of Feed Match Event + Feed Match Action + Action data properties (with some exceptions described below, marked with *) 

Card

Element

Type

Description

type

string($x-extensible-enum)

[ Unknown, Yellow, SecondYellow, Red ]

Type data

player

{}

Player in card data

id

string

Unique player identifier

name

string

Player name

CardsReliability

Element

Type

Description

type

string($x-extensible-enum)

[ Unknown, Yellow, SecondYellow, Red ]

Type data

isReliable

boolean

Indicates whether Cards related data is reliable

ClockSet

No specific properties. Sets the game clock.

ClockStarted

No specific properties. Starts the game clock.

ClockStopped

No specific properties. Stops the game clock.

Comment

Element

Type

Description

text

string

Text of the comment

messageId

integer

Message identifier

CornerAwarded

Element

Type

Description

isTaken

boolean

Indicates whether the corner is taken

Corner

Element

Type

Description

awardedGameTime

string($date-span)

Time the corner was awarded

CornerRisk

No specific properties. There is a risk of a corner.

CornerRiskEnded

No specific properties. The corner risk is ended.

CornersReliability

Element

Type

Description

isReliable

boolean

Indicates whether Corners related data is reliable

DangerStateChanged

Element

Type

Description

state

string($x-extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Indicates the danger state of the game

FreeKick

Element

Type

Description

state

string($x-extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Indicates the dangers state of the game when the free kick is awarded

Goal

Element

Type

Description

isOwn

boolean

Indicates if the goal is own goal

penalty

boolean

Indicates if the goal was scored from penalty

assistingPlayer

{}

Player that assisted for the goal (not supported)

id

string

Unique player identifier

name

string

Player name

GoalKick

No specific properties. Goal kick is taken.

GoalsReliability

Element

Type

Description

isReliable

boolean

Indicates whether Goals related data is reliable

KickOff

No specific properties. Kick-off.

Lineup

Element

Type

Description

formation

string

Team formation

lineup

Lineup array

Lineup collection for the game

id

string

Lineup unique player identifier

name

string

Lineup player’s full name

firstName

string

Lineup player’s first name

lastName

string

Lineup player’s last name

playerStatus

string($x-extensible-enum)

[ Unknown, Starter, Bench, Injured, Suspended, Unavailable ]

Lineup player’s game status

position

string($x-extensible-enum)

[ Unknown, GoalKeeper, Defender, Midfielder, Forward ]

Lineup player’s position

shirtNumber

string

Lineup player’s shirt number

MatchStatusChanged

Element

Type

Description

matchStatus

string($x-extensible-enum)

[Unknown, NotStarted, Warmup, InProgress, Postponed, Finished, Interrupted, CoverageStopped, CoverageResumed, Abandoned, Cancelled, Delayed ]

Indicates the state of the game

Offside

No specific properties. Offside.

PenaltyAwarded

No specific properties. Penalty as awarded.

PenaltyMissed

No specific properties. Penalty is missed.

PenaltyRetake

No specific properties. Penalty is/will be retaken.

PenaltyRisk

No specific properties. Risk of a penalty.

PenaltyRiskEnded

No specific properties. Risk of a penalty is over.

PeriodChanged

No specific properties.

RedCardRisk

No specific properties. Risk of a red card.

RedCardRiskEnded

No specific properties. Risk of a red card is over.

ShirtColorMajor

Element

Type

Description

Color

string

Major shirt color

ShirtColorMinor

Element

Type

Description

color

string

Minor shirt color

Shot

Element

Type

Description

onTarget

boolean

Indicates the shot is on target.

hitWoodwork

boolean

Indicates the shot hit the woodwork

blocked

boolean

Indicates the shot is blocked

StoppageTime

Element

Type

Description

announcedMinutes

integer

Game’s stoppage time

Substitution

Element

Type

Description

out

{}

Player being subbed out

in

{}

Player being subbed in

id

string

Unique player identifier

name

string

Player’s name

ThrowIn

Element

Type

Description

state

string($x-extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Danger state data

Var

Element

Type

Description

varReason

string($x-extensible-enum)

[ NotSet, HomeGoal, HomePenalty, HomeRedCard, HomeMistakenIdentity, AwayGoal, AwayPenalty, AwayRedCard, AwayMistakenIdentity, Goal, Penalty, RedCard, MistakenIdentity, HomeUnknown, AwayUnknown, Unknown, PenaltyRetake, HomePenaltyRetake, AwayPenaltyRetake ]

Reason for initiation of VAR

VarEnded

Element

Type

Description

varOutcome

string($x-extensible-enum)

[ NotSet, HomeNoGoal, AwayNoGoal, NoGoal, HomeGoalAwarded, AwayGoalAwarded, GoalAwarded, HomeNoPenalty, AwayNoPenalty, NoPenalty, HomePenaltyAwarded, AwayPenaltyAwarded, PenaltyAwarded, HomeNoRedCard, AwayNoRedCard, NoRedCard, HomeRedCardGiven, AwayRedCardGiven, RedCardGiven, HomePlayerNotChanged, AwayPlayerNotChanged, PlayerNotChanged, HomePlayerChanged, AwayPlayerChanged, PlayerChanged, HomeNoAction, AwayNoAction, NoAction, HomeUnknown, AwayUnknown, Unknown, HomePenaltyWillBeRetaken, AwayPenaltyWillBeRetaken, HomeNoPenaltyRetake, AwayNoPenaltyRetake, PenaltyWillBeRetaken, NoPenaltyRetake ]

Outcome of the initiated VAR

VarRisk

Element

Type

Description

varReason

string($x-extensible-enum)

[ NotSet, HomeGoal, HomePenalty, HomeRedCard, HomeMistakenIdentity, AwayGoal, AwayPenalty, AwayRedCard, AwayMistakenIdentity, Goal, Penalty, RedCard, MistakenIdentity, HomeUnknown, AwayUnknown, Unknown, PenaltyRetake, HomePenaltyRetake, AwayPenaltyRetake ]

Potential reason for initiation of VAR

VarRiskEnded

No specific properties. Indicated the VAR risk is over.

YellowCardRisk

No specific properties. Indicates there is a risk of yellow card.

YellowCardRiskEnded

No specific properties. Indicates the risk of yellow card is over.

Statistics *

Element

Type

Description

possession

{}

Possession data field

home

integer

Home team possession in percentages

away

integer

Away team possession in percentages

utcTimestamp

string($date-time)

Timestamp of the message

*This action contains utcTimestamp property but does not contain team, period and gameTime.

Other Match Events

Reliability

Element

Type

Description

isReliable

boolean

Indicates whether the feed data is considered reliable

reason

string

Reason of reliable/unreliable feed state