Page Comparison

Table of Contents

Feed Match Event

Example Ably LiveAccess URL: https://platform.matchstate.api.geniussports.com/api/v1/sources/GeniusPremium/sports/17/fixtures/10173048/liveaccess/matchevents?sportApiVersion=v2

Code Block

{
    "SportId": 17,
    "FixtureId": "91143158",
    "Source": "GeniusPremiumReplay",
    "SequenceId": 1606,
    "ActionId": 839,
    "InsertedBeforeActionId": null,
    "IsCancelled": false,
    "IsConfirmed": false,
    "IsModified": true,
    "Action": {},
    "MessageTimestampUtc": "2022-05-19T10:31:24.0121616Z"
}

Element	Type	Description
`SportId`	Integer	Sport Identifier (17 for American Football)
`FixtureId`	String	Unique fixture identifier
`Source`	String	Feed Provider information
`SequenceId`	Integer	Sequence Id of feed match events
`ActionId`	Integer	Unique match action identifier
`InsertedBeforeActionId`	Integer	Identifier used to specify before which action Id this specific action was inserted (in case this insertion is done before previously published match events)
`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`	Match action array	Consists of Match Action data properties
`MessageTimestampUtc`	String($date-time)	Timestamp of the message

Feed Match Action

Info
NOTE: All Feed Match Actions includes the following additional fields (hence it’s not copy-pasted to every action described below).

Code Block
"Team": "Away", "GameTime": "00:00:00", "Period": { "Number": 1, "ProgressStatus": "NotStarted", "Type": "Regular" }, "UtcTimestamp": "2022-05-19T09:24:26.7008204Z"

Element	Type	Description
`Team`	string($x-extensible-enum) [ None, Home, Away ]	Team data
`GameTime`	string($date-span)	Game time data
`Period`	Period array	Period in the game data
`Number`	integer($int32)	Period number
`ProgressStatus`	string($x-extensible-enum) [ NotStarted, InProgress,

Finished

Complete ]

Period progress status

Type

string($x-extensible-enum)

[ Regular, Overtime ]

Period type data

UtcTimestamp

string($date-time)

Timestamp of the message

Actions

Info
NOTE: All Feed Match Actions consist of Feed Match Event + Feed Match Action + Action data properties

Fumble

Code Block

{

Fumbler

subtype":

{ "Id": "835822", "Name": null }, "Recoverer": null, "Yards": 40, "TeamInPossession": "None", }

Element	Type	Description
`Fumbler`	Fumbler Player array	Fumbler action data
`Id`	integer($int32)	Unique player Id
`Name`	string	Player name
`Recoverer`	integer($int32)	Unique player Id
`Yards`	integer($int32)	Yards where the ball was recovered/fumbled
`TeamInPossession`	string($x-extensible-enum) [ None, Home, Away ]	Team in possession

PassAttempt (called Pass in v1)

Code Block {

 null,
            "yards": 33,
            "yardLine": {
                "yards": 33,
                "sideOfPitch": "Home"
            },
            "teamInPossession": "None",
            "isNullified": false,
            "

Passer

players": [
                {
                    "

Id

id": "

493258

1014921",
                    "

Name

type": "Fumbled"

null

             }
            ],

}

Element	Type	Description
`Passer`	Passer data array	Passer data
`Id`	integer($int32)	Unique player Id
`Name`	string	Player name

IncompletePass

Code Block
{ }

No player or yards data. Just an event to record an incomplete pass fact.

CompletePass

Code Block { "Receiver": {

 "team": "Home",
            "

Id

gameTime": "

1005455

00:00:00",

Name

period": null,

}, "Yards": 11 }

"utcTimestamp": "2023-10-23T00:45:16.9535449Z"

Element	Type	Description

Receiver

Players

Receiver data

Player array

Receiver data

Player data
`subtype`	string($x-extensible-enum) [FumbledSnap, FumbledHandOff],	Indicates second level of action description
`yardline`		Indicates where fumble action on the field happened
`Id`	integer($int32)	Unique player Id

Name

Type

string

Player name

Interception

Code Block

Type of action performed by the player
`Yards`	integer($int32)

Indicates Air Yards + Yards after catch

Yards where the ball was recovered/fumbled

TeamInPossession

string($x-extensible-enum)

[ None, Home, Away ]

Team in possession

PassAttempt (called Pass in v1)

Code Block
{ "

Player

Players": [
                {
                    "Id": "

796218

493258",
                    "Name":

null

 "Passer"
                }

Element	Type	Description
`Player`	Interception player data array	Interception player data
`Id`	integer($int32)	Unique player Id
`Name`	string	Player name

FieldGoal

Code Block


            ]
        }

Element	Type	Description
`Players`	Players array	Player data

IncompletePass

Code Block
{ "

IsMade

Players": [

true,

"IsNullified":

false,

"Yards":

23,

         "Id": "493258",

"Player":

{

Id

Name": "

1014731

Passer"

,

"Name":

null

         ]
        }

Element	Type	Description

IsMadeFieldGoalAttempt

Players

boolean

Indicates whether FG was made

IsNullified

boolean

Indicates whether this action was nullified

Yards

integer($int32)

Indicates yards from there the FG was taken

Player

FG player data array

FG player data

Id

integer($int32)

Unique player Id

Name

string

Player name

Players array

Player data

CompletePass

Code Block
{ "Players": [

"IsNullified":

false

}

Element	Type	Description
`IsNullified`	boolean	Indicates whether this action was nullified

TimeoutsRemaining

Code Block {

Away

Id":

2,

"493258",
                    "

Home

Name":

3Home

"Passer"
                }
            ],
            "Yards": 11
		}

Element	Type	Description

Away

integer($int32)

Number of timeouts remaining for away team

Timeout

Code Block
{ }

No player or yards data. Just an event to record a timeout fact.

Snap

Code Block
{ "IsConfirmed": false }

Element	Type	Description
`IsConfirmed`	boolean	Indicates if it is confirmed or not

Touchdown

`Players`	Players array	Player data
`Yards`	integer($int32)

Number of timeouts remaining for home team

Indicates Air Yards + Yards after catch

Interception

Code Block
{ "

IsNullified

Players": [

false,

"Player":

 {
                    "Id": "

935576

493258",
                    "Name":

null

 "Passer"
                }

Player


            ]
        }

Element	Type	Description

IsNullified

boolean

Indicates whether this action was nullified

Players

Players array

Player data

array

Touchdown player data

Id

integer($int32)

Unique player Id

Name

string

Player name

Run

FieldGoal

Code Block
{ "

Yards

IsMade":

2

true,
            "

Player

IsNullified":

{

false,

Id

Yards":

"1085742"

23,
            "Players": [

"Name":

null

}

Element	Type	Description
`Yards`	integer($int32)	Indicates how many yards a player rushed
`Player`	Player data array	Run player data
`Id`	integer($int32)	Unique player Id
`Name`	string	Player name

Tackle

Code Block {

"Tackler":

{

                 "Id": "

1014275

493258",
                    "Name":

null

"Kicker"

},

"Tackled":

null,

"Yards": null

]
		}

Element	Type	Description

TacklerUnique player Id

IsMade

Player data array

Tackle player data

Id

integer($int32)

Unique player Id

Name

string

Player name

Tackled

integer($int32)

boolean	Indicates whether FG was made
`IsNullified`	boolean	Indicates whether this action was nullified
`Yards`	integer($int32)	Indicates

where the tackle happened

Comment

Code Block
{ "Text": "2-Minute Warning" }

Element	Type	Description
`Text`	string	Comments provided by Feed Prodiver

NextPlay

yards from there the FG was taken
`Players`	Players array	Player data

FieldGoalAttempt

Code Block
{

Type

Players":

"Snap",

"LineOfScrimmage":

 {
                    "

ScrimmageYard

Id":

40,

"493258",
                    "

SideOfPitch

Name": "

Away

Kicker"
                }

,

"DownNumber": 1

],
            "

YardsToGo

IsNullified":

10,

false

"IsConfirmed": true }

Safety

Code Block
{ IsNullified: false, "Player": null }

Element	Type	Description
`IsNullified`	boolean	Indicates whether this action was nullified
`Player`	integer($int32)	Unique player Id

OnePointSafety

Code Block
{ IsNullified: false, "Player": null }

Element	Type	Description
`IsNullified`	boolean	Indicates whether this action was nullified
`Player`	integer($int32)	Unique player Id

ClockSet

Code Block
{ }

No player or yards data. Just an event to record a clock set fact.

ClockStarted

Code Block
{ }

No player or yards data. Just an event to record a clock start fact.

ClockStopped

Code Block
{ }

No player or yards data. Just an event to record a clock stop fact.

CoinToss

Code Block { "WinnerTeam": null

Element	Type	Description

Type

string($x-extensible-enum)

[ Snap, Kickoff, Pat ]

Next Play Type

LineOfScrimmage

LOS data array

LOS data

ScrimmageYard

integer($int32)

Scrimmage Yard Line

SideOfPitch

string($x-extensible-enum)

[ None, Home, Away ]

Indicates the side of the pitch if it’s home or away

DownNumber

integer($int32)

Number of the next Down

YardsToGo

integer($int32)

Yards to go for successful

IsConfirmed

boolean

Indicates if it is confirmed or not

`Players`	Players array	Player data
`IsNullified`	boolean	Indicates whether this action was nullified

FieldGoalBlocked

Code Block
{ "Players": [ { "Id": "493258", "Name": "Kicker" } ], "IsNullified": false }

Element	Type	Description
`Players`	Players array	Player data
`IsNullified`

TimeoutsRemaining

Code Block
{ "Away": 2, "

WasDeferred

Home":

false,

"AwayChoice": "Receive", "HomeChoice": "EastEndZone",

WasDeferred

Element	Type	Description
`Away`	integer($int32)	Number of timeouts remaining for away team
`Home`	integer($int32)	Number of timeouts remaining for home team

Timeout

Code Block
{ }

No player or yards data. Just an event to record a timeout fact.

Snap

Code Block
{ "IsConfirmed": false }

Element	Type	Description

WinnerTeam

integer($int32)

team Id

IsConfirmed

boolean

Indicates

whether choice deferred

ConversionAttempt

if it is confirmed or not

AwayChoice

string($x-extensible-enum)

[ Kick, Receive, EndZone, NorthEndZone, EastEndZone, SouthEndZone, WestEndZone ]

Indicates the away team choice from the available options.

HomeChoice

string($x-extensible-enum)

[ Kick, Receive, EndZone, NorthEndZone, EastEndZone, SouthEndZone, WestEndZone ]

Indicates the home team choice from the available options.

Touchdown

Code Block
{

"Type":

"TwoPoints",

"

"IsNullified": false

}

Element

Type

Description

Type

string($x-extensible-enum)

[ Unknown, OnePoint

TwoPoints ]

Indicated the type of conversion attempt play

IsNullified

boolean

Indicates whether this action was nullified

OnePointConversion

Code Block { "IsMade": true,

IsNullified

Players": [

false,

"Player":

 {
                    "Id": "

835715

493258",
                    "Name": "Scorer"

null

} }

   }
            ]
        }

Element	Type	Description

IsMade

boolean

Indicates whether this action was made or not


`IsNullified`	boolean	Indicates whether this action was nullified

Player

Players

Player data TwoPointsConversion

Players array

Player data

Id

integer($int32)

Unique player Id

Name

string

Player name

Single

Code Block
{

"IsMade


            "IsNullified": false,
            "

Passer

Players":

null,

"Receiver":

null,

"IsNullified":

false

}

Element	Type	Description
`IsMade`	boolean	Indicates whether this action was made or not
`Passer`	integer($int32)	Unique player Id
`Receiver`	integer($int32)	Unique player Id
`IsNullified`	boolean	Indicates whether this action was nullified

OutOfBounds

Code Block { "Yards":

null,

        "Id": "493258",

"Player":

{

Id

Name": "

835822

Kicker"

,

"Name": null

}
            ]

}

Player

Element	Type	Description

Yards

integer($int32)

Indicates the yard line where out of bounds happened

`IsNullified`	boolean	Indicates whether this action was nullified
`Players`	Player data array

Player

Kicker player data
`Id`	integer($int32)	Unique

player Touchback

kicker Id
`Name`	string

Player name

two possible values: “Kicker” or null

Run

Code Block
{

"Player


            "Yards": 2,
            "Players":

null

}

				{
					"Id": "835822",
					"Type": "Runner"
				}
			]
		}

Element	Type	Description

PlayerPenalty

Yards

integer($int32)

Unique player Id

Indicates how many yards a player rushed
`Players`	Players array	Player data

RunAfterCatch

Code Block
{

"Type": "OffensiveHolding",


            "Yards":

10

2,
            "

Outcome

Players":

"Accepted", "Player":

[
				{
					"Id": "835822",
					"Type": "Runner"
				}
			]
		}

Element	Type	Description
`Yards`	integer($int32)	Indicates how many yards a player rushed
`Players`	Players array	Player data

Kneel

Code Block
{ "Players": [

				{
					"Id": "

1239286

835822",

					"Type": "Runner"
				}
			],
		}

Element	Type	Description
`Players`	Players array	Player data

Tackle

Code Block
{ "

Name

Players": [
				{
					"Id":

null

"835822",
					"Type": "Tackler"
				}
			],

}

Return

Code Block { "Yards": 28,

    "Yards": null
		}

Element	Type	Description

Type

string($x-extensible-enum)

Unknown, OffensiveHolding, FalseStart, DefensivePassInterference, OffensivePassInterference, DefensiveHolding, UnnecessaryRoughness, DefensiveOffside, DelayOfGame, IllegalBlockAboveTheWaist, NeutralZoneInfraction, FaceMask, IllegalUseOfHands, RoughingThePasser, UnsportsmanlikeConduct, IllegalFormation, Encroachment, IllegalContact, Defensive12OnField, IllegalShift, IntentionalGrounding, Taunting, OffsideOnFreeKick, IneligibleDownfieldPass, HorseCollarTackle, Leverage, RoughingTheKicker, IllegalMotion, ChopBlock, IllegalTouchKick, RunningIntoTheKicker, Disqualification, InterferenceWithOpportunityToCatch, Offensive12OnField, PlayerOutOfBoundsOnPunt, IllegalSubstitution, OffensiveOffside, IllegalTouchPass, FairCatchInterference, Clipping, IllegalForwardPass, IllegalBlindsideBlock, Tripping, Leaping, IneligibleDownfieldKick, InvalidFairCatchSignal, IllegalCrackback, LowBlock, DelayOfKickoff, DefensiveDelayOfGame, IllegalBat, IllegallyKickingBall, KickoffOutOfBounds, IllegalCut

Penalty type

Yards

integer($int32)

Indicates the amount of yards team was penalized based on the penalty type

Outcome

string($x-extensible-enum)

Unknown, Accepted, Declined, Offsetting, Superseded

Outcome of the penalty

Player

Player data array

Player data

Id

integer($int32)

Unique player Id

Name

string

Player name

`Players`	Players array	Player data
`Yards`	integer($int32)	Indicates where the tackle happened

Comment

Code Block
{ "Text": "2-Minute Warning" }

Element	Type	Description
`Text`	string	Comments provided by Feed Prodiver

NextPlay

Code Block
{ "Type": "Snap", "LineOfScrimmage": { "

Player

ScrimmageYard":

{

40,
        "SideOfPitch": "Away"
    },
    "

Id

DownNumber":

"1011264"

1,
    "YardsToGo": 10,
    "IsConfirmed": true
    "

Name

Team":

null }

"Home"
}

Element	Type	Description

Yards

Player

Player data array

Player data

Id

Type

integer($int32)

Indicates the yards gained

Name

string

Player name

Down

string($x-extensible-enum)

[ Snap, Kickoff, Pat ]

Next Play Type

LineOfScrimmage

LOS data array

LOS data

ScrimmageYard

integer($int32)

Unique player Id

Scrimmage Yard Line
`SideOfPitch`	string($x-extensible-enum) [ None, Home, Away ]	Indicates the side of the pitch if it’s home or away
`DownNumber`	integer($int32)	Number of the next Down
`YardsToGo`	integer($int32)	Yards to go for successful
`IsConfirmed`	boolean	Indicates if it is confirmed or not
`Team`	string($x-extensible-enum) [ None, Home, Away ]	Team data

Safety

Code Block
{ IsNullified: false, "

Number

Players":

2, "YardsToGo": 8, "ScrimmageYard": 22, "EndedAtGameTime": null, "EndedAtUtc": null, "Description": "(14:23) (No Huddle) D.Dallas right guard to SEA 25 for 3 yards (Jon.Allen)." }

Element	Type	Description
`Number`	integer($int32)	Number of the Down in a Play
`YardsToGo`	integer($int32)	Indicates yards to go for a successful down
`ScrimmageYard`	integer($int32)	Scrimmage Yard line
`EndedAtGameTime`	string($date-span)	game clock data
`EndedAtUtc`	string($date-span)	time of the day
`Description`	string	Description by Feed Provider

Sack

Code Block

[],
		}

Element	Type	Description
`IsNullified`	boolean	Indicates whether this action was nullified
`Players`	Players array	Player data

OnePointSafety

Code Block
{ IsNullified: false, "Players": [], }

Element	Type	Description
`IsNullified`	boolean	Indicates whether this action was nullified
`Players`	Players array	Player data

ClockSet

Code Block
{ }

No player or yards data. Just an event to record a clock set fact.

ClockStarted

Code Block
{ }

No player or yards data. Just an event to record a clock start fact.

ClockStopped

Code Block
{ }

No player or yards data. Just an event to record a clock stop fact.

CoinToss

Code Block
{ "

Yards

WinnerTeam":

-4

null,
            "

QuarterBack

WasDeferred":

{

false,
            "

Id

AwayChoice": "

493258

Receive",

Name

HomeChoice":

null }, "SackerOne": { "Id": "1005288", "Name": null }

"EastEndZone",
		}

Element	Type	Description
`WinnerTeam`	integer($int32)	team Id
`WasDeferred`	boolean	Indicates whether choice deferred or not
`AwayChoice`	string($x-extensible-enum) [ Kick, Receive, EndZone, NorthEndZone, EastEndZone, SouthEndZone, WestEndZone ]	Indicates the away team choice from the available options.
`HomeChoice`	string($x-extensible-enum) [ Kick, Receive, EndZone, NorthEndZone, EastEndZone, SouthEndZone, WestEndZone ]	Indicates the home team choice from the available options.

ConversionAttempt

Code Block
{ "Type": "TwoPoints", "

SackerTwo

IsNullified":

null

false
		}

Element	Type	Description

Yards

QuarterBack

Player data array

Player data

Id

integer($int32)

Unique player Id

Name

string

Player name

SackerOne

Player data array

Player data

Id

integer($int32)

Unique player Id

Name

string

Player name

SackerTwo

Player data array

Player data

KickOff

Type

integer($int32)

Indicates yards behind the Scrimmage Line

string($x-extensible-enum)

[ Unknown, OnePoint, TwoPoints ]

Indicated the type of conversion attempt play

IsNullified

boolean

Indicates whether this action was nullified

OnePointConversion

Code Block
{ "

Yards

IsMade":

9

true,
            "

Player

IsNullified":

{

false,
            "Players": [

				{
					"Id": "

835715

835822",

"Name

					"Type":

null }

Possession

Code Block
{ }

No player or yards data. Just an event to record a possession of the ball fact.

YardsToEndzone

"Tackler"
				}
			]
		}

Element	Type	Description

Yards

integer($int32)

Indicates how far (in terms of yards) the ball was kicked

Player

Player data array

Player data

Id

integer($int32)

Unique player Id

Name

string

Player name

`IsMade`	boolean	Indicates whether this action was made or not
`IsNullified`	boolean	Indicates whether this action was nullified
`Players`	Players array	Player data

TwoPointsConversion

Code Block
{

"Value": 76 }

Element	Type	Description
`Value`	integer($int32)	Indicates yards to End Zone

MatchStatusChanged

Code Block { "MatchStatus": "Finished"

"IsMade": false,
            "Players": [
				{
					"Id": "835822",
					"Type": "Tackler"
				}
			],
            "IsNullified": false
		}

Element	Type	Description

MatchStatus

string($x-extensible-enum)

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

Indicates match status

PeriodChanged

Code Block
{ }

No player or yards data. Just an event to record a period change fact.

Punt


`IsMade`	boolean	Indicates whether this action was made or not
`Players`	Players array	Player data
`IsNullified`	boolean	Indicates whether this action was nullified

OutOfBounds

Code Block
{ "Yards":

53

null,
            "

Player

Players":

{ "Id": "1007198", "Name": null } }

Element

Type

[],
		}

Element	Type	Description
`Yards`	integer($int32)

yards gained

Player

Player data Risks

Indicates the yard line where out of bounds happened
`Players`	Players array	Player data

Id

integer($int32)

Unique player Id

Name

string

Player name

Touchback

Code Block
{ "

Touchdown

Players":

"NonActive", "OnsideKick

[],
		}

Element	Type	Description
`Players`	Players array	Player data

Penalty

Code Block
{ "type": "

NonActive

DefensiveOffside",
            "

FieldGoal

yards":

"NonActive"

5,
            "

FourthDown

outcome": "

NonActive

Accepted",
            "

Safety

yardLines":

"NonActive",

 [
                {

"Challenge":

"NonActive",

Penalty

type": "

NonActive

Placement",
                    "

VideoReview

yards":

"NonActive",

39,
                    "

Turnover

sideOfPitch": "

NonActive

Home"

,

"Other": "Active" }

Element

Type

Description

Touchdown

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

Touchdown risk

OnsideKick

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

Onside Kick risk

FieldGoal

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

Field Goal risk

FourthDown

   }
            ],
            "enforcementSpot": "PreviousSpot",
            "nextDown": "Repeats",
            "players": [
                {
                    "id": "1006731",
                    "type": "Unknown"
                }
		}

Element	Type	Description
`Type`	string($x-extensible-enum)

[

Unknown, BlockBelowWaist, BlockingOutOfBounds,

Active, NonActive ]

Fourth Down risk

Safety

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

Safety risk

Challenge

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

Challenge risk

Penalty

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

Penalty risk

VideoReview

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

VideoReview risk

Turnover

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

Turnover risk

Other

string($x-extensible-enum)

[ Unknown, Active, NonActive ]

Other risk

FairCatch

Code Block
{ "Yards": null, "Player": { "Id": "100", "Name": null } }

Element	Type	Description
`Yards`	integer($int32)	yard line
`Player`	Player data array	Player data
`Id`	integer($int32)	Unique player Id
`Name`	string	Player name

Challenge

Code Block
{ "Result": "Won" }

Element

Type

Description

Result

string($x-extensible-enum)

[ Unknown, Won, Lost ]

Result of the challenge

Other Match Events

Reliability

Code Block { "IsReliable": false, "Reason": "Unreliable score"

ChopBlock, Clipping, ContactingTheKicker, CutBlocking, Defensive12OnField, DefensiveDelayOfGame, DefensiveHolding, DefensiveOffside, DefensivePassInterference, DefensiveTooManyMenOnField, DelayOfGame, DelayOfKickoff, DisconcertingSignals, Disqualification, Encroachment, EquipmentViolation, FaceMask, FairCatchInterference, FalseStart, Fighting, Holding, HoldingReturn, HorseCollarTackle, Hurdling, IllegalBat, IllegalBlindsideBlock, IllegalBlock, IllegalBlockAboveTheWaist, IllegalBlockAboveWaist, IllegalBlockAfterFcSignal, IllegalBlockInBack, IllegalBlockOnReturn, IllegalContact, IllegalContactWithSnapper, IllegalCrackback, IllegalCut, IllegalDoubleTeamBlock, IllegalDownfieldOnKick, IllegalFormation, IllegalForwardPass, IllegalInterferenceCover, IllegalInterferenceOnLooseBall, IllegalKickoff, IllegallyKickingBall, IllegalMotion, IllegalParticipation, IllegalPeelback, IllegalPunt, IllegalShift, IllegalSnap, IllegalSubstitution, IllegalTouchKick, IllegalTouchOfKick, IllegalTouchPass, IllegalUseOfHands, IllegalWedge, IneligibleDownfieldKick, IneligibleDownfieldOnPass, IneligibleDownfieldPass, IneligibleReceiver, IntentionalGrounding, InterferenceWithOpportunityToCatch, InvalidFairCatchSignal, KickCatchInterference, KickoffOutOfBounds, Leaping, Leverage, LowBlock, LoweringHeadToInitiateContact, NeutralZoneInfraction, NoYards15, NoYards5, ObjectionableConduct, Offensive12OnField, OffensiveHolding, OffensiveOffside, OffensivePassInterference, OffensiveTooManyMenOnField, Offside, OffsideOnFreeKick, PassInterference, PersonalFoul, PhysicalAbuseOnOfficial, PilingOn, PlayerOutOfBoundsOnKick, PlayerOutOfBoundsOnPunt, ProcedureGeneral, ProcedureIllegalFormation, ProcedureNoEnd, PushBlocking, Pyramiding, ReturnFromOutOfBounds, RoughingHolder, RoughingTheKicker, RoughingThePasser, RoughPlay, RunningIntoHolder, RunningIntoTheKicker, ShortFreeKick, SidelineInterference, Spearing, Targeting, Taunting, TimeCountAfter3MinuteWarningIntentional, TimeCountAfter3MinuteWarningLoss10Yards, TimeCountAfter3MinuteWarningLossDown, TimeCountAfter3MinuteWarningUnintentional, TimeCountBefore3MinuteWarning, TooManyPlayers, Tripping, UnnecessaryRoughness, UnnecessaryRoughnessMajorGrade2, UnsportsmanlikeConduct	Penalty type
`Yards`	integer($int32)	Indicates the amount of yards team was penalized based on the penalty type
`Outcome`	string($x-extensible-enum) Unknown, Accepted, Declined, Offsetting, Superseded	Outcome of the penalty
`YardLines`	Yardlines array	Indicates enforcement and placement yardlines of the penalty if both available.
`EnforcementSpot`	string($x-extensible-enum) Unknown, Accepted, Declined, Offsetting, Superseded	Indicates where the penalty is enforced from. Available options: [Unknown, DeadBall, OtherSpot, PreviousSpot, SuccedingSpot]
`NextDown`	string($x-extensible-enum) Unknown, Accepted, Declined, Offsetting, Superseded	Indicates if penalty results in firstDown, LossOfDown or down Repeats. Available options: [Unknown, First, Repeats, LossOfDown]
`Players`	Players array	Player data

Return

Code Block
{ "Yards": 28, "Players": [ { "Id": "835822", "Type": "Returner" } ], }

Element	Type	Description
`Yards`	integer($int32)	Indicates the yards gained
`Players`	Players array	Player data

Down

Code Block
{ "Number": 2, "YardsToGo": 8, "ScrimmageYard": 22, "EndedAtGameTime": null, "EndedAtUtc": null, "Description": "(14:23) (No Huddle) D.Dallas right guard to SEA 25 for 3 yards (Jon.Allen)." }

Element	Type	Description
`Number`	integer($int32)	Number of the Down in a Play
`YardsToGo`	integer($int32)	Indicates yards to go for a successful down
`ScrimmageYard`	integer($int32)	Scrimmage Yard line
`EndedAtGameTime`	string($date-span)	game clock data
`EndedAtUtc`	string($date-span)	time of the day
`Description`	string	Description by Feed Provider

Sack

Code Block
{ "Yards": -4, "Players": [ { "Id": "835822", "Type": "Tackled" } ] }

Element	Type	Description
`Yards`	integer($int32)	Indicates yards behind the Scrimmage Line
`Players`	Players array	Player data

KickOff

Code Block
"subtype": null, "yards": 65, "isNullified": false, "players": [ { "id": "998755", "type": "Kicker" } ],

Element	Type	Description
`Yards`	integer($int32)	Indicates how far (in terms of yards) the ball was kicked
`Players`	Players array	Player data

Possession

Code Block
{ }

No player or yards data. Just an event to record a possession of the ball fact.

YardsToEndzone

Code Block
{ "Value": 76 }

Element	Type	Description
`Value`	integer($int32)	Indicates yards to End Zone

MatchStatusChanged

Code Block
{ "MatchStatus": "Finished" }

Element

Type

Description

MatchStatus

string($x-extensible-enum)

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

Indicates match status

PeriodChanged

Code Block
{ }

No player or yards data. Just an event to record a period change fact.

Punt

Code Block
{ "Yards": 53, "Players": [ { "Id": "835822", "Type": "Kicker" } ] }

Element	Type	Description
`Yards`	integer($int32)	yards gained
`Players`	Players array	Player data

Risks

Code Block

		{
			"Touchdown": "NonActive",
            "OnsideKick": "NonActive",
            "FieldGoal": "NonActive",
            "FourthDown": "NonActive",
            "Safety": "NonActive",
            "Challenge": "NonActive",
            "Penalty": "NonActive",
            "VideoReview": "NonActive",
            "Turnover": "NonActive",
            "PlayAboutToStart": "NonActive",
            "injury": "Active",
            "bigPlay": "Active",
            "statDelay": "Active"
            "Other": "Active"		
		}

Element	Type	Description
`Touchdown`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Touchdown risk
`OnsideKick`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Onside Kick risk
`FieldGoal`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Field Goal risk
`FourthDown`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Fourth Down risk
`Safety`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Safety risk
`Challenge`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Challenge risk
`Penalty`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Penalty risk
`VideoReview`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	VideoReview risk
`Turnover`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Turnover risk
`PlayAboutToStart`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Indicates that the play is about to start (teams are lining up to begin the play).
`Other`	string($x-extensible-enum) [ Unknown, Active, NonActive ]	Other risk

FairCatch

Code Block
{ "Yards": null, "Players": [ { "Id": "835822", "Type": "Receiver" } ], }

Element	Type	Description
`Yards`	integer($int32)	yard line
`Players`	Players array	Player data

Challenge

Code Block
{ "Result": "Won" }

Element

Type

Description

Result

string($x-extensible-enum)

[ Unknown, Won, Lost ]

Result of the challenge

Lateral

Code Block
{ "IsNullified": false, "Yards": 5, "Players": [ { "Id": "493258", "Name": "Receiver" } ] }

Element	Type	Description
`Yards`	integer($int32)	Indicates how many yards was the lateral.
`Players`	Players array	Player data
`IsNullified`	boolean	Indicates whether this action was nullified

Other Match Events

Reliability

Code Block
{ "IsReliable": false, "Reason": "Unreliable score" }

Element	Type	Description
`IsReliable`	boolean	Indicates whether the current match events are reliable or not
`Reason`	string	Reason

CurrentLineup

Code Block

 "teamType": "Offensive",
            "players": [
                {
                    "position": "Quarterback",
                    "side": "Middle",
                    "id": "165525",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "TightEnd",
                    "side": "Middle",
                    "id": "99040",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "Tackle",
                    "side": "Unknown",
                    "id": "719357",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "Tackle",
                    "side": "Unknown",
                    "id": "757902",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "WideReceiver",
                    "side": "Unknown",
                    "id": "796224",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "Tackle",
                    "side": "Unknown",
                    "id": "1017511",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "RunningBack",
                    "side": "Middle",
                    "id": "1015480",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "Center",
                    "side": "Middle",
                    "id": "1018160",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "TightEnd",
                    "side": "Middle",
                    "id": "1011409",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "TightEnd",
                    "side": "Middle",
                    "id": "1006903",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "Tackle",
                    "side": "Unknown",
                    "id": "1014143",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "Guard",
                    "side": "Middle",
                    "id": "1008250",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "TightEnd",
                    "side": "Middle",
                    "id": "1008026",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "Quarterback",
                    "side": "Middle",
                    "id": "1005917",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "Tackle",
                    "side": "Unknown",
                    "id": "1014804",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "WideReceiver",
                    "side": "Unknown",
                    "id": "1017215",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "RunningBack",
                    "side": "Middle",
                    "id": "1028378",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "WideReceiver",
                    "side": "Unknown",
                    "id": "1003947",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "WideReceiver",
                    "side": "Unknown",
                    "id": "1009826",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "WideReceiver",
                    "side": "Unknown",
                    "id": "1016007",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "RunningBack",
                    "side": "Middle",
                    "id": "999394",
                    "name": null,
                    "status": "Started"
                },
                {
                    "position": "Guard",
                    "side": "Middle",
                    "id": "998896",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "WideReceiver",
                    "side": "Unknown",
                    "id": "998934",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "Guard",
                    "side": "Middle",
                    "id": "796929",
                    "name": null,
                    "status": "Unknown"
                },
                {
                    "position": "Guard",
                    "side": "Middle",
                    "id": "999405",
                    "name": null,
                    "status": "Started"
                }
                ],
                "team": "Home",
                "gameTime": "00:00:00",
                "period": null,
                "utcTimestamp": "2023-04-05T05:01:11.8805131Z"
            },
            "messageTimestampUtc": "2023-04-05T05:01:19.6152104Z"

Element	Type	Description
`TeamType`	string [Unknown, Offensive, Defensive, Special]	Type of the team players are assigned to
`Players`	Array Of Lineup Player	Lineup players array
`id`	string	Indicates an Unique id of the player
`position`	string	Indicates the position of the player. Available options: [Unknown, Kicker, Punter, Returner, RunningBack, Fullback, WideReceiver, TightEnd, Tackle, Guard, Quarterback, Center, End, Linebacker, Cornerback, Safety, Holder, LongSnapper, DefensiveBack, OffensiveLineman, DefensiveLineman] For CFL there is also available options: [Kickreturner, Nosetackle, Slotback, Puntreturner]
`side`	string	Indicates the side of the player. Available options: [Unknown, Right, Middle, Left]
`status`	string	Indicates the status of the player during the game. Available options: Started - Player was in the starting 11 Substituted - Player took part for at least one play during the match and was not in the Starting 11 ActiveNotPlayed - Player was dressed up for the game but did not play NotActive - Player was not dressed up for the game Unknown - Player status in not known

Muff

Code Block
{ "IsNullified": false "Players": [ { "Id": "835822", "Type": "Muffed" } ] }

Element	Type	Description

IsReliable

IsNullified

boolean

Indicates whether

the current match events are reliable or not

Reason

string

Reason

CurrentLineup

Code Block { "TeamType": null, "Players": {}

Muff

Code Block
{ "IsNullified": false "Player": { "Id": "10012", "Name": null } }

Element	Type	Description
`IsNullified`	boolean	Indicates whether this action was nullified
`Player`	Player data array	Player data
`Id`	integer($int32)	Unique player Id
`Name`	string	Player name

Recovery

Code Block
{ "Yards": 15 "IsNullified": false "Player": { "Id": "10022", "Name": null } }

Element

Type

Description

Yards

integer($int32)

Indicates the amount of yards from the point where opponents recovered the ball to the point where the play finished

IsNullified

boolean

Indicates whether this action was nullified

Player

Player data array

Player data

Id

integer($int32)

Unique player Id

Name

string

Player name

this action was nullified
`Players`	Players array	Player data

Recovery

Code Block
{ "Yards": 15 "IsNullified": false "Players": [ { "Id": "835822", "Type": "Recoverer" } ], }

Element	Type	Description

TeamType

string
[Unknown, Offensive, Defensive, Special]

Type of the team players are assigned to

Players

Array Of Lineup Player

Lineup players array

`Yards`	integer($int32)	Indicates the amount of yards from the point where opponents recovered the ball to the point where the play finished
`IsNullified`	boolean	Indicates whether this action was nullified
`Players`	Players array	Player data

Players

Player type	Valid action types	Explanation
`Unknown`	-	Not used
`Tackled`	`Tackle` `Sack` `Fumble`	The player that was tackled
`Tackler`	`Tackle` `Sack` `Fumble`	The player who tackled, in case of `Tackle` - primary tackler
`TackleAssister`	`Tackle`	The player who assisted tackling in the tackle (secondary tackler). Tackle can have two tackle assisters and no tackler
`Scorer`	`Touchdown`	The player who scored the points
`Receiver`	`PassAttempt` `CompletedPass` `IncompletePass` `Interception` `FairCatch` `ConversionAttempt` `ConversionMade` `ConversionMissed` `Lateral`	The player who is the intended receiver for a pass or fair catch. In case of conversions, only for two point conversion when it is passed
`Passer`	`PassAttempt` `CompletedPass` `IncompletePass` `Interception` `ConversionAttempt` `ConversionMade` `ConversionMissed`	The player who passed the ball. In case of conversions, only for two point conversion when it is passed
`Fumbled`	`Fumble`	The player who fumbled the ball
`Recoverer`	`Recovery` `Fumble`	The player who recovered the ball
`Kicker`	`KickOff` `Punt` `FieldGoalAttempt` `FieldGoalMade` `FieldGoalBlocked` `FieldGoalMissed` `ConversionAttempt` `ConversionMade` `ConversionMissed` `ConversionBlocked`	The play who kicked the ball. In case of conversions, only for one point conversion
`Runner`	`Run` `RunAfterCatch` `Kneel` `ConversionAttempt` `ConversionMade` `ConversionMissed` `Fumble`	The player who runs with the ball. In case of conversions, only for two point conversion when it is rushed
`Returner`	`Return`	The player who attempts to make a return with the ball
`Interceptor`	`Interception`	The player who intercepts the pass
`Blocker`	`FieldGoalAttempt` `FieldGoalBlocked` `ConversionAttempt ConversionBlocked` `Punt` `PuntBlocked`	The player who blocks the kick
`QbHitter`	`PassAttempt` `CompletedPass` `IncompletePass` `Sack`	The player/s who hit the quarterback to the ground
`PassDefender`	`PassAttempt` `IncompletePass`	The player/s who earn pass defended on incomplete pass
`Muffed`	`Muff`	The player who muffs the catch

Version	Old Version 1	New Version Current
Changes made by	Martin Kuks	Iryna Antonova
Saved on	Jul 05, 2022	Dec 05, 2024

Page Comparison

Versions Compared

Key

Feed Match Event

Feed Match Action

Actions

Fumble

PassAttempt (called Pass in v1)

IncompletePass

CompletePass

Interception

PassAttempt (called Pass in v1)

FieldGoal

IncompletePass

CompletePass

TimeoutsRemaining

Timeout

Snap

Interception

FieldGoal

Tackle

Comment

FieldGoalAttempt

Safety

OnePointSafety

ClockSet

ClockStarted

ClockStopped

CoinToss

FieldGoalBlocked

TimeoutsRemaining

Timeout

Snap

ConversionAttempt

Touchdown

OnePointConversion

Single

OutOfBounds

Run

RunAfterCatch

Kneel

Tackle

Return

Comment

NextPlay

Down

Safety

Sack

OnePointSafety

ClockSet

ClockStarted

ClockStopped

CoinToss

ConversionAttempt

KickOff

OnePointConversion

Possession

TwoPointsConversion

MatchStatusChanged

PeriodChanged

Punt

OutOfBounds

Touchback

Penalty

FairCatch

Challenge

Other Match Events

Reliability

Return

Down

Sack

KickOff

Possession

YardsToEndzone

MatchStatusChanged

PeriodChanged

Punt

Risks

FairCatch

Challenge