Versions Compared

Version Old Version 4 New Version 5
Changes made by

Martin Kuks

Alexandru Iftimiciuc

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel7

Feed Match Event

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

Element

Type

Description

sportId

integer

Sport

Identifier

identifier (10 for Football)

fixtureId

string

Unique fixture

Fixture identifier

source

string

Feed

Provider information

provider identifier

sequenceId

integer

Sequence Id of feed match events

Fixture specific sequence identifier of the match event

actionId

integer

Unique match

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”“action” field, named after the respective Action. Example for KickOff below, where “KickOff” is replaced for different Actions.

json
Code Block
language
"a  ctionaction": {     "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.KickOffDto, Betgenius.Sports.Football.Contracts.MatchEvents"

Feed Match Action

Info

NOTE: All Actions inside Feed Match Actions includes Event include the following additional fields (hence it’s not copy-pasted to they are not included in the description of every action described below).

Code Block
languagejson
{"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

progressStatus

string($x-extensible-enum)

[ NotStarted, InProgress, Finished ]

Period progress status

type

string($date-span)

Game time data

ActionsActions 

Info

NOTE: All Feed Match Actions consist of Feed Match Event + Feed Match Action + Action data properties (with some exceptions described

bellow

below, marked with *) 

Card

{
Code Block
languagejson
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CardDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "type": "Yellow"
    "player": {
        "id": 456683,
        "name": "Dwight Jork"
    }
}

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

Code Block
languagejson
{{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CardsReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",        
    "type": "Yellow",
    "isReliable": false,        
}

Element

Type

Description

type

string($x-extensible-enum)

[ Unknown, Yellow, SecondYellow, Red ]

Type data

isReliable

boolean

Indicates whether

the current match events are reliable or not

Cards related data is reliable

ClockSet

Code Block
{}

No specific properties. Sets the game clock.

ClockStarted

Code Block
{}

No specific properties. Starts the game clock.

ClockStopped

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ClockSetDto, Betgenius.Sports.Football.Contracts.MatchEvents"      
}

No specific properties. Stops Sets the game clock.

CommentDto

ClockStarted

json
Code Block
language
{
    "text$type": "Weather: night",Betgenius.Sports.Football.Contracts.MatchEvents.ClockStartedDto, Betgenius.Sports.Football.Contracts.MatchEvents"     "messageId": 0,
}

Element

Type

Description

text

string

Text of the comment

messageId

integer

Message id

CornerAwarded

Code Block
languagejson
{

No specific properties. Starts the game clock.

ClockStopped

Code Block
{
    "isTaken$type": false,        
}

Element

Type

Description

isTaken

boolean

Indicates whether the corner is taken

CornerDto

Code Block
languagejson
{"Betgenius.Sports.Football.Contracts.MatchEvents.ClockStoppedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Stops the game clock.

Comment

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CommentDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "awardedGameTimetext": "00:43:25Weather: night",
       "messageId": 0,
}

Element

Type

Description

awardedGameTime

text

string

($date-span)

Time the corner was awarded

CornerRisk

Code Block
languagejson
{}

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

CornerRiskEnded

Code Block
languagejson
{}

No specific properties. The corner risk is ended.

CornersReliability

Code Blocklanguagejson

Text of the comment

messageId

integer

Message identifier

CornerAwarded

Code Block
{
    "isReliable$type": false,"Betgenius.Sports.Football.Contracts.MatchEvents.CornerAwardedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "isTaken": false
}

Element

Type

Description

isReliable

isTaken

boolean

???

DangerStateChanged

Code Blocklanguagejson

Indicates whether the corner is taken

Corner

Code Block
{
    "state$type": "Safe",
}

Element

Type

Description

state

string($x-extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Danger statedata

FreeKick

Code Block
languagejson
{Betgenius.Sports.Football.Contracts.MatchEvents.CornerDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "stateawardedGameTime": "Safe00:43:25",        
}

Element

Type

Description

state

awardedGameTime

string(

$x

$date-

extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Danger state data

Goal

Code Blocklanguagejson

span)

Time the corner was awarded

CornerRisk

Code Block
{
    "isOwn$type": null,
    "penalty": null,"Betgenius.Sports.Football.Contracts.MatchEvents.CornerRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

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

CornerRiskEnded

Code Block
{
    "assistingPlayer$type": {
        "id": 456683,
    "Betgenius.Sports.Football.Contracts.MatchEvents.CornerRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. The corner risk is ended.

CornersReliability

Code Block
{
    "name$type": "Dwight Jork"Betgenius.Sports.Football.Contracts.MatchEvents.CornersReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "isReliable": }false,
}

Element

Type

Description

isOwn

isReliable

boolean

Indicates

if the goal is own goal

penalty

boolean

Indicates if the goal was scored from penalty

assistingPlayer

{}

Player in goal data

id

string

Unique player identifier

name

string

Player name

GoalKick

Code Block
languagejson
{}

No specific properties. Goal kick is taken.

GoalsReliability

Code Block
languagejson
{

whether Corners related data is reliable

DangerStateChanged

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.DangerStateChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "isReliablestate": false"Safe",
}

Element

Type

Description

isReliable

boolean

Indicated whether the data in the goals collection in the Match state is reliable

KickOff

Code Block
languagejson
{}

No specific properties. Kick-off.

Lineup

Code Blocklanguagejson

state

string($x-extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Indicates the danger state of the game

FreeKick

Code Block
{
    "lineup$type": {
        "$values": [
            {
            "Betgenius.Sports.Football.Contracts.MatchEvents.FreeKickDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "idstate": "1256517",
           Safe",
}

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

Code Block
{
    "name$type": "Cuesta, WBetgenius.Sports.Football.Contracts.MatchEvents.GoalDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "isOwn": false,
    "penalty": true,
    "firstNameassistingPlayer": "William"null,
       "player": {
        "lastName$type": "CuestaBetgenius.Sports.Football.Contracts.MatchEvents.PlayerDto, Betgenius.Sports.Football.Contracts.MatchEvents",
                "playerStatus": "Starter",
       "Id": "1226671",
        "positionName": "GoalKeeper",De la                "shirtNumber": "1Rosa, R"
            },
            {
           }
}

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

Code Block
{
    "id$type": "1256504",
           Betgenius.Sports.Football.Contracts.MatchEvents.GoalKickDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Goal kick is taken.

GoalsReliability

Code Block
{
    "name$type": "Marulanda, J",
           Betgenius.Sports.Football.Contracts.MatchEvents.GoalsReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "firstNameisReliable": "Jonathan",
           false,
}

Element

Type

Description

isReliable

boolean

Indicates whether Goals related data is reliable

KickOff

Code Block
{
    "lastName$type": "Marulanda",
           Betgenius.Sports.Football.Contracts.MatchEvents.KickOffDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Kick-off.

Lineup

Code Block
{
    "playerStatus$type": "StarterBetgenius.Sports.Football.Contracts.MatchEvents.LineupDto, Betgenius.Sports.Football.Contracts.MatchEvents",
       "lineup": {
        "position$values": "Defender",[
             {
  "shirtNumber": "4"             }"$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

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

Code Block
{
   ] "$type":    },
   "Betgenius.Sports.Football.Contracts.MatchEvents.MatchStatusChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "formationmatchStatus": null,
}

Element

Type

Description

formation

string

Team formation

lineup

Lineup array

Lineup collection in game data

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 players’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

json
Code Block
language
"InProgress",   
}

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

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.OffsideDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Offside.

PenaltyAwarded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyAwardedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Penalty as awarded.

PenaltyMissed

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyMissedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Penalty is missed.

PenaltyRetake

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRetakeDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Penalty is/will be retaken.

PenaltyRisk

Code Block
{
    "matchStatus$type": "InProgress",   
}

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

Code Block
languagejson
{Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Risk of a penalty.

PenaltyRiskEnded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. OffsideRisk of a penalty is over.

PenaltyAwarded

PeriodChanged

Code Block
languagejson
{}

No specific properties. Penalty as awarded.

PenaltyMissed

{
Code Block
languagejson
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PeriodChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Penalty is missed.

PenaltyRetake

RedCardRisk

Code Block
languagejson
{}

No specific properties. Penalty is/will be retaken ???.

PenaltyRisk

{
Code Block
languagejson
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.RedCardRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Risk of a penaltyred card.

PenaltyRiskEnded

RedCardRiskEnded

Code Block
languagejson
{}

No specific properties. Risk of a penalty is over

.

PeriodChanged

{
Code Block
languagejson
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.RedCardRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

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

RedCardRisk

ShirtColorMajor

Code Block
languagejson
{}

No specific properties. Risk of a red card

RedCardRiskEnded

Code Block
languagejson
{}

No specific properties. Risk of a red card is over

ShirtColorMajor

{
Code Block
languagejson
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShirtColorMajorDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "Color": "skyblue"
}

Element

Type

Description

Color

string

Major shirt color

ShirtColorMinor

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShirtColorMinorDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "Color": "skyblue",
}
Code Block
languagejson
{

Element

Type

Description

Color

color

string

Major shirt color.

ShirtColorMinor

Minor shirt color

Shot

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShotDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "onTarget": null,
    "colorhitWoodwork": null,
    "skyblueblocked": null, 
}
languagejson

Element

Type

Description

color

string

Minor shirt color.

Shot

Code Block

onTarget

boolean

Indicates the shot is on target.

hitWoodwork

boolean

Indicates the shot hit the woodwork

blocked

boolean

Indicates the shot is blocked

StoppageTime

Code Block
{
    "onTarget$type": null,
    "hitWoodwork": null"Betgenius.Sports.Football.Contracts.MatchEvents.StoppageTimeDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "blockedannouncedMinutes": null, 
}

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

Code Block
languagejson
{
    "announcedMinutes": 5,
}

Element

Type

Description

announcedMinutes

integer

Game’s stoppage time

Substitution

Code Block
languagejson
{ 5,
}

Element

Type

Description

announcedMinutes

integer

Game’s stoppage time

Substitution

Code Block
{
    "$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

out

{}

Player being subbed out

in

{}

Player being subbed in

id

string

Unique player

id

identifier

name

string

Player’s name

ThrowIn

Code Block
languagejson
{

ThrowIn

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ThrowInDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "state": "Unknown"
}
Code Block
languagejson
{

Element

Type

Description

state

string($x-extensible-enum)

[ Unknown

, Safe, Attack, DangerousAttack ]

Danger state data

Var

, Safe, Attack, DangerousAttack ]

Danger state data

Var

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "varReason": "Penalty"
}

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 ]

Var reason data

VarEnded

Code Block
languagejson
{

Reason for initiation of VAR

VarEnded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "varOutcome": "AwayPenaltyAwarded"
}
Code Block
languagejson
{

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 ]

Var outcome data

VarRisk

, HomeNoPenaltyRetake, AwayNoPenaltyRetake, PenaltyWillBeRetaken, NoPenaltyRetake ]

Outcome of the initiated VAR

VarRisk

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "varReason": "HomeGoal"
}
Code Block
languagejson
{

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 ]

Var reason data

VarRiskEnded

, HomePenaltyRetake, AwayPenaltyRetake ]

Potential reason for initiation of VAR

VarRiskEnded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Indicated the VAR risk is over.

YellowCardRisk

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.YellowCardRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Indicated the VAR risk is overIndicates there is a risk of yellow card.

YellowCardRisk

YellowCardRiskEnded

Code Block
languagejson
{}

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

YellowCardRiskEnded

{
Code Block
languagejson
{
    "Betgenius.Sports.Football.Contracts.MatchEvents.YellowCardRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

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

Statistics *

Code Block
{
    "$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

{}

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 have UtcTimestamp contains utcTimestamp property but does not Teamcontain team, Period and GameTime as the rest period and gameTime.

Other Match Events

Reliability

Code Block
	{
	"$type": "Betgenius.Sports.Contracts.Common.MatchEvents.Reliability, Betgenius.Sports.Contracts.Common.MatchEvents",
	"isReliable": false,
   
    "reason": "Unreliable score"		
	}

Element

Type

Description

isReliable

boolean

Indicates whether the

current match events are reliable or not

feed data is considered reliable

reason

string

Reason of reliable/unreliable feed state