Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

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, Finished ]

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

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

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

text

string

Text of the comment

messageId

integer

Message identifier

CornerAwarded

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

Element

Type

Description

isTaken

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

awardedGameTime

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

isReliable

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

state

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

state

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

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

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

isReliable

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

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

{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.MatchStatusChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "matchStatus": "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

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

Color

string

Major shirt color

ShirtColorMinor

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

Element

Type

Description

color

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

onTarget

boolean

Indicates the shot is on target.

hitWoodwork

boolean

Indicates the shot hit the woodwork

blocked

boolean

Indicates the shot is blocked

StoppageTime

{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.StoppageTimeDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "announcedMinutes": 5,
}

Element

Type

Description

announcedMinutes

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

out

{}

Player being subbed out

in

{}

Player being subbed in

id

string

Unique player identifier

name

string

Player’s name

ThrowIn

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

Element

Type

Description

state

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

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

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

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

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

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

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

{}

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

{
	"$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 feed data is considered reliable

reason

string

Reason of reliable/unreliable feed state

  • No labels