Football Match Events V1 (old)
- 1 Feed Match Event
- 2 Feed Match Action
- 3 Actions
- 3.1 Card
- 3.2 CardsReliability
- 3.3 ClockSet
- 3.4 ClockStarted
- 3.5 ClockStopped
- 3.6 Comment
- 3.7 CornerAwarded
- 3.8 Corner
- 3.9 CornerRisk
- 3.10 CornerRiskEnded
- 3.11 CornersReliability
- 3.12 DangerStateChanged
- 3.13 FreeKick
- 3.14 Goal
- 3.15 GoalKick
- 3.16 GoalsReliability
- 3.17 KickOff
- 3.18 Lineup
- 3.19 MatchStatusChanged
- 3.20 Offside
- 3.21 PenaltyAwarded
- 3.22 PenaltyMissed
- 3.23 PenaltyRetake
- 3.24 PenaltyRisk
- 3.25 PenaltyRiskEnded
- 3.26 PeriodChanged
- 3.27 RedCardRisk
- 3.28 RedCardRiskEnded
- 3.29 ShirtColorMajor
- 3.30 ShirtColorMinor
- 3.31 Shot
- 3.32 StoppageTime
- 3.33 Substitution
- 3.34 ThrowIn
- 3.35 Var
- 3.36 VarEnded
- 3.37 VarRisk
- 3.38 VarRiskEnded
- 3.39 YellowCardRisk
- 3.40 YellowCardRiskEnded
- 3.41 Statistics *
- 4 Other Match Events
- 4.1 Reliability
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 |
---|---|---|
| integer | Sport identifier (10 for Football) |
| string | Fixture identifier |
| string | Feed provider identifier |
| integer | Fixture specific sequence identifier of the match event |
| integer | Match action identifier |
| boolean | Indicates whether the action is cancelled |
| boolean | Indicates whether the action is confirmed |
| boolean | Indicates whether the action is modified |
| {} | Consists of Match Action data properties |
| 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 |
---|---|---|
| string($x-extensible-enum) [ None, Home, Away ] | Team data |
| string($date-span) | Game time data |
| {} | Period in the game data |
| string($date-time) | Timestamp of the message |
| integer($int32) | Period number |
| string($x-extensible-enum) [ NotStarted, InProgress, Complete] | Period progress status |
| string($date-span) | Game time data |
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 |
---|---|---|
| string($x-extensible-enum) [ Unknown, Yellow, SecondYellow, Red ] | Type data |
| {} | Player in card data |
| string | Unique player identifier |
| string | Player name |
CardsReliability
Element | Type | Description |
---|---|---|
| string($x-extensible-enum) [ Unknown, Yellow, SecondYellow, Red ] | Type data |
| 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 |
---|---|---|
| string | Text of the comment |
| integer | Message identifier |
CornerAwarded
Element | Type | Description |
---|---|---|
| boolean | Indicates whether the corner is taken |
Corner
Element | Type | Description |
---|---|---|
| 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 |
---|---|---|
| boolean | Indicates whether Corners related data is reliable |
DangerStateChanged
Element | Type | Description |
---|---|---|
| string($x-extensible-enum) [ Unknown, Safe, Attack, DangerousAttack ] | Indicates the danger state of the game |
FreeKick
Element | Type | Description |
---|---|---|
| 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 |
---|---|---|
| boolean | Indicates if the goal is own goal |
| boolean | Indicates if the goal was scored from penalty |
| {} | Player that assisted for the goal (not supported) |
| string | Unique player identifier |
| string | Player name |
GoalKick
No specific properties. Goal kick is taken.
GoalsReliability
Element | Type | Description |
---|---|---|
| boolean | Indicates whether Goals related data is reliable |
KickOff
No specific properties. Kick-off.
Lineup
Element | Type | Description |
---|---|---|
| string | Team formation |
| Lineup array | Lineup collection for the game |
| string | Lineup unique player identifier |
| string | Lineup player’s full name |
| string | Lineup player’s first name |
| string | Lineup player’s last name |
| string($x-extensible-enum) [ Unknown, Starter, Bench, Injured, Suspended, Unavailable ] | Lineup player’s game status |
| string($x-extensible-enum) [ Unknown, GoalKeeper, Defender, Midfielder, Forward ] | Lineup player’s position |
| string | Lineup player’s shirt number |
MatchStatusChanged
Element | Type | Description |
---|---|---|
| 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 |
---|---|---|
| string | Major shirt color |
ShirtColorMinor
Element | Type | Description |
---|---|---|
| string | Minor shirt color |
Shot
Element | Type | Description |
---|---|---|
| boolean | Indicates the shot is on target. |
| boolean | Indicates the shot hit the woodwork |
| boolean | Indicates the shot is blocked |
StoppageTime
Element | Type | Description |
---|---|---|
| integer | Game’s stoppage time |
Substitution
Element | Type | Description |
---|---|---|
| {} | Player being subbed out |
| {} | Player being subbed in |
| string | Unique player identifier |
| string | Player’s name |
ThrowIn
Element | Type | Description |
---|---|---|
| string($x-extensible-enum) [ Unknown, Safe, Attack, DangerousAttack ] | Danger state data |
Var
Element | Type | Description |
---|---|---|
| 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 |
---|---|---|
| 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 |
---|---|---|
| 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 data field |
| integer | Home team possession in percentages |
| integer | Away team possession in percentages |
| 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 |
---|---|---|
| boolean | Indicates whether the feed data is considered reliable |
| string | Reason of reliable/unreliable feed state |