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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CardDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"type": "Yellow"
"player": {
"id": 456683,
"name": "Dwight Jork"
}
}
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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CardsReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"type": "Yellow",
"isReliable": false,
}
Element | Type | Description |
---|---|---|
| string($x-extensible-enum) [ Unknown, Yellow, SecondYellow, Red ] | Type data |
| boolean | Indicates whether Cards related data is reliable |
ClockSet
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ClockSetDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Sets the game clock.
ClockStarted
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ClockStartedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Starts the game clock.
ClockStopped
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ClockStoppedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Stops the game clock.
Comment
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CommentDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"text": "Weather: night",
"messageId": 0,
}
Element | Type | Description |
---|---|---|
| string | Text of the comment |
| integer | Message identifier |
CornerAwarded
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornerAwardedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"isTaken": false
}
Element | Type | Description |
---|---|---|
| boolean | Indicates whether the corner is taken |
Corner
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornerDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"awardedGameTime": "00:43:25",
}
Element | Type | Description |
---|---|---|
| string($date-span) | Time the corner was awarded |
CornerRisk
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornerRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. There is a risk of a corner.
CornerRiskEnded
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornerRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. The corner risk is ended.
CornersReliability
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornersReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"isReliable": false,
}
Element | Type | Description |
---|---|---|
| boolean | Indicates whether Corners related data is reliable |
DangerStateChanged
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.DangerStateChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"state": "Safe",
}
Element | Type | Description |
---|---|---|
| string($x-extensible-enum) [ Unknown, Safe, Attack, DangerousAttack ] | Indicates the danger state of the game |
FreeKick
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.FreeKickDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"state": "Safe",
}
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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.GoalDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"isOwn": false,
"penalty": true,
"assistingPlayer": null,
"player": {
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PlayerDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"Id": "1226671",
"Name": "De la Rosa, R"
}
}
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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.GoalKickDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Goal kick is taken.
GoalsReliability
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.GoalsReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"isReliable": false,
}
Element | Type | Description |
---|---|---|
| boolean | Indicates whether Goals related data is reliable |
KickOff
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.KickOffDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Kick-off.
Lineup
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.LineupDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"lineup": {
"$values": [
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.LineupInfoDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"id": "1256517",
"name": "Cuesta, W",
"firstName": "William",
"lastName": "Cuesta",
"playerStatus": "Starter",
"position": "GoalKeeper",
"shirtNumber": "1"
},
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.LineupInfoDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"id": "1256504",
"name": "Marulanda, J",
"firstName": "Jonathan",
"lastName": "Marulanda",
"playerStatus": "Starter",
"position": "Defender",
"shirtNumber": "4"
},
...
]
},
"formation": null,
}
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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.MatchStatusChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"matchStatus": "InProgress",
}
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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.OffsideDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Offside.
PenaltyAwarded
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyAwardedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Penalty as awarded.
PenaltyMissed
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyMissedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Penalty is missed.
PenaltyRetake
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRetakeDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Penalty is/will be retaken.
PenaltyRisk
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Risk of a penalty.
PenaltyRiskEnded
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Risk of a penalty is over.
PeriodChanged
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PeriodChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties.
RedCardRisk
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.RedCardRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Risk of a red card.
RedCardRiskEnded
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.RedCardRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Risk of a red card is over.
ShirtColorMajor
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShirtColorMajorDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"Color": "skyblue"
}
Element | Type | Description |
---|---|---|
| string | Major shirt color |
ShirtColorMinor
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShirtColorMinorDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"Color": "skyblue"
}
Element | Type | Description |
---|---|---|
| string | Minor shirt color |
Shot
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShotDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"onTarget": null,
"hitWoodwork": null,
"blocked": null,
}
Element | Type | Description |
---|---|---|
| boolean | Indicates the shot is on target. |
| boolean | Indicates the shot hit the woodwork |
| boolean | Indicates the shot is blocked |
StoppageTime
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.StoppageTimeDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"announcedMinutes": 5,
}
Element | Type | Description |
---|---|---|
| integer | Game’s stoppage time |
Substitution
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.SubstitutionDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"out": {
"id": null,
"name": null
},
"in": {
"id": null,
"name": null
}
}
Element | Type | Description |
---|---|---|
| {} | Player being subbed out |
| {} | Player being subbed in |
| string | Unique player identifier |
| string | Player’s name |
ThrowIn
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ThrowInDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"state": "Unknown"
}
Element | Type | Description |
---|---|---|
| string($x-extensible-enum) [ Unknown, Safe, Attack, DangerousAttack ] | Danger state data |
Var
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"varReason": "Penalty"
}
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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"varOutcome": "AwayPenaltyAwarded"
}
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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"varReason": "HomeGoal"
}
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
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Indicated the VAR risk is over.
YellowCardRisk
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.YellowCardRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Indicates there is a risk of yellow card.
YellowCardRiskEnded
{
"Betgenius.Sports.Football.Contracts.MatchEvents.YellowCardRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}
No specific properties. Indicates the risk of yellow card is over.
Statistics *
{
"$type": "Betgenius.Sports.Football.Contracts.MatchEvents.StatisticsDto, Betgenius.Sports.Football.Contracts.MatchEvents",
"possession": {
"home": 61,
"away": 39
},
utcTimestamp: "2022-06-19T23:29:04Z"
}
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
{
"$type": "Betgenius.Sports.Contracts.Common.MatchEvents.Reliability, Betgenius.Sports.Contracts.Common.MatchEvents",
"isReliable": false,
"reason": "Unreliable score"
}
Element | Type | Description |
---|---|---|
| boolean | Indicates whether the feed data is considered reliable |
| string | Reason of reliable/unreliable feed state |