Page Comparison

Table of Contents

minLevel	1
maxLevel	6
outline	false
style	default
type	list
printable	true

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": "Home", "gameTime": "00:10:00", "period": { "number": 1, "progressStatus": "NotStarted", "type": "Regular" }, "utcTimestamp": "2023-09-24T18:19:09.5924521Z" }

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

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Fumble, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "subtype": "FumbledHandoff",
  "yards": 45,
  "yardLine": {
    "yards": 45,
    "sideOfPitch": "Away"
  },
  "teamInPossession": "None",
  "isNullified": false,
  "players": [
    {
      "id": "999739",
      "type": "Fumbled"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Fumble, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`players`	Player array	Player data
`subtype`	string($x-extensible-enum) [Unknown, FumbledSnap, FumbledHandoff, Tackled, PushedOutOfBounds, RanOutOfBounds, Onside, Advanced, NotAdvanced]	Indicates second level of action description
`yardLine`	Yardlines array	Indicates enforcement and placement yardlines of the penalty if both available
`id`	integer($int32)	Unique player Id
`type`	string	Type of action performed by the player
`yards`	integer($int32)	Yards where the ball was recovered/fumbled
`teamInPossession`	string($x-extensible-enum) [None, Home, Away]	Team in possession
`sideOfPitch`	string($x-extensible-enum) [ None, Home, Away ]	Indicates the side of the pitch if it’s home or away
`isNullified`	boolean	Indicates whether this action is nullified

PassAttempt (called Pass in v1)

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.PassAttempt, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "isNullified": false,
  "players": [
    {
      "id": "1072633",
      "type": "Passer"
    },
    {
      "id": "999739",
      "type": "Receiver"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.PassAttempt, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`players`	Players array	Player data
`isNullified`	boolean	Indicates whether this action is nullified
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

IncompletePass

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.IncompletePass, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "isNullified": false,
  "yardLine": null,
  "subtype": null,
  "players": [
    {
      "id": "1016285",
      "type": "Passer"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.IncompletePass, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`players`	Players array	Player data
`isNullified`	boolean	Indicates whether this action is nullified
`yardLine`	Yardlines array	Indicates enforcement and placement yardlines of the penalty if both available
`subtype`
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

CompletePass

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.CompletePass, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": 0,
  "isNullified": false,
  "yardLine": null,
  "players": [
    {
      "id": "998871",
      "type": "Passer"
    },
    {
      "id": "758163",
      "type": "Receiver"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.CompletePass, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`players`	Players array	Player data
`isNullified`	boolean	Indicates whether this action is nullified
`yardLine`	Yardlines array
`yards`	integer($int32)	Indicates Air Yards + Yards after catch
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Interception

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Interception, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "isNullified": false,
  "yardLine": null,
  "players": [
    {
      "id": "1072679",
      "type": "Passer"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Interception, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`isNullified`	boolean	Indicates whether this action is nullified
`yardLine`	Yardlines array
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

FieldGoal

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.FieldGoal, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "isMade": true,
  "isNullified": false,
  "yards": 57,
  "yardLine": null,
  "players": [
    {
      "id": "998755",
      "type": "Kicker"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.FieldGoal, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`isMade`	boolean	Indicates whether FG was made
`isNullified`	boolean	Indicates whether this action is nullified
`yards`	integer($int32)	Indicates yards from there the FG was taken
`yardLine`	Yardlines array
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

FieldGoalAttempt

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.FieldGoalAttempt, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "isNullified": false,
  "yardLine": null,
  "players": [
    {
      "id": "998755",
      "type": "Kicker"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.FieldGoalAttempt, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?
`isNullified`	boolean	Indicates whether this action was nullified
`yardLine`	Yardlines array

FieldGoalBlocked

Code Block
{ "players": [ { "id": "493258", "name": "Kicker" } ], "isNullified": false }

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

TimeoutsRemaining

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.TimeoutsRemaining, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents", "away": 3, "home": 3 }

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.TimeoutsRemaining, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`away`	integer($int32)	Number of timeouts remaining for away team
`home`	integer($int32)	Number of timeouts remaining for home team

Timeout

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Timeout, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents" }

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

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Timeout, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]

Snap

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Snap, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents", "isConfirmed": false }

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Snap, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`isConfirmed`	boolean	Indicates if it is confirmed or not

Touchdown

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Touchdown, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "isNullified": false,
  "players": [
    {
      "id": "998787",
      "type": "Scorer"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Touchdown, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Single

Code Block
{ "isNullified": false, "players": [ { "id": "493258", "name": "Kicker" } ] }

Element	Type	Description
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Player data array	Kicker player data
`id`	integer($int32)	Unique kicker Id
`name`	string	two possible values: “Kicker” or null

Run

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Run, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": null,
  "isNullified": false,
  "players": [
    {
      "id": "998871",
      "type": "Runner"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Run, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`yards`	integer($int32)	Indicates how many yards a player rushed
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

RunAfterCatch

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.RunAfterCatch, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": 26,
  "isNullified": false,
  "players": [
    {
      "id": "998787",
      "type": "Runner"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.RunAfterCatch, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`yards`	integer($int32)	Indicates how many yards a player rushed
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Kneel

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Kneel, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": null,
  "isNullified": false,
  "yardLine": null,
  "players": [
    {
      "id": "1072679",
      "type": "Runner"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Kneel, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`yards`	integer($int32)	Indicates how many yards a player rushed
`isNullified`	boolean	Indicates whether this action was nullified
`yardLine`	Yardlines array
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Tackle

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Tackle, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": null,
  "yardLine": {
    "yards": 22,
    "sideOfPitch": "Away"
  },
  "isNullified": false,
  "players": [
    {
      "id": "941270",
      "type": "Tackler"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Tackle, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`yardLine`	Yardlines array
`sideOfPitch`	string($x-extensible-enum) [ None, Home, Away ]	Indicates the side of the pitch if it’s home or away
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?
`yards`	integer($int32)	Indicates where the tackle happened

Comment

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Comment, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents", "text": "2-Minute Warning" }

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Comment, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`text`	string	Comments provided by Feed Prodiver

NextPlay

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.NextPlay, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "type": null,
  "lineOfScrimmage": {
    "scrimmageYard": 24,
    "sideOfPitch": "Home"
  },
  "downNumber": 2,
  "yardsToGo": 13,
  "isConfirmed": false,
  "team": "Home"
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.NextPlay, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`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
`team`	string($x-extensible-enum) [ None, Home, Away ]	Team data

Safety

Code Block
{ "isNullified": false, "players": [] }

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
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.ClockStarted, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents" }

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

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.ClockStarted, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]

ClockStopped

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.ClockStopped, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents" }

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

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.ClockStopped, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]

CoinToss

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.CoinToss, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "winnerTeam": "Away",
  "wasDeferred": false,
  "awayChoice": "Receive",
  "homeChoice": null
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.CoinToss, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`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": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.ConversionAttempt, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "type": "OnePoint",
  "isNullified": false,
  "yardLine": null,
  "players": [
    {
      "id": "1080636",
      "type": "Kicker"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.ConversionAttempt, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`type`	string($x-extensible-enum) [ Unknown, OnePoint, TwoPoints ]	Indicated the type of conversion attempt play
`isNullified`	boolean	Indicates whether this action was nullified
`yardLine`	Yardlines array
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

OnePointConversion

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.OnePointConversion, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "isMade": true,
  "isNullified": false,
  "players": [
    {
      "id": "1080636",
      "type": "Kicker"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.OnePointConversion, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`isMade`	boolean	Indicates whether this action was made or not
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

TwoPointsConversion

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.TwoPointsConversion, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "isMade": false,
  "isNullified": false,
  "players": [
    {
      "id": "1075217",
      "type": "Recoverer"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.TwoPointsConversion, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`isMade`	boolean	Indicates whether this action was made or not
`players`	Players array	Player data
`isNullified`	boolean	Indicates whether this action was nullified
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

OutOfBounds

Code Block
{ "yards": null, "players": [] }

Element	Type	Description
`yards`	integer($int32)	Indicates the yard line where out of bounds happened
`players`	Players array	Player data

Touchback

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Touchback, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents", "isNullified": false, "players": null }

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Touchback, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data

Penalty

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Penalty, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "type": "DefensiveOffside",
  "yards": 5,
  "outcome": "Accepted",
  "yardLines": [
    {
      "type": "Placement",
      "yards": 22,
      "sideOfPitch": "Away"
    }
  ],
  "enforcementSpot": "PreviousSpot",
  "nextDown": "Repeats",
  "players": [
    {
      "id": "1014528",
      "type": "Unknown"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Penalty, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`type`	string($x-extensible-enum) Unknown, BlockBelowWaist, BlockingOutOfBounds, 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.
`type`
`sideOfPitch`	string($x-extensible-enum) [ None, Home, Away ]	Indicates the side of the pitch if it’s home or away
`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
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Return

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Return, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": null,
  "yardLine": {
    "yards": 1,
    "sideOfPitch": "Home"
  },
  "isNullified": false,
  "subtype": null,
  "players": [
    {
      "id": "1013138",
      "type": "Returner"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Return, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`yards`	integer($int32)	Indicates the yards gained
`yardLine`	Yardlines array
`sideOfPitch`	string($x-extensible-enum) [ None, Home, Away ]	Indicates the side of the pitch if it’s home or away
`subtype`
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Down

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Down, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "number": 2,
  "yardsToGo": 1,
  "scrimmageYard": 34,
  "endedAtGameTime": null,
  "endedAtUtc": null,
  "description": "(1:37) (No Huddle, Shotgun) 15-P.Mahomes scrambles ran ob at KC 37 for 3 yards (54-F.Warner)."
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Down, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`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

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Sack, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "subtype": "Tackled",
  "yards": 0,
  "isNullified": false,
  "yardLine": null,
  "players": [
    {
      "id": "998871",
      "type": "Tackled"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Sack, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`subtype`
`yards`	integer($int32)	Indicates yards behind the Scrimmage Line
`isNullified`	boolean	Indicates whether this action was nullified
`yardLine`	Yardlines array
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

KickOff

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.KickOff, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "subtype": null,
  "yards": 65,
  "isNullified": false,
  "players": [
    {
      "id": "1080636",
      "type": "Kicker"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.KickOff, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`subtype`
`yards`	integer($int32)	Indicates yards behind the Scrimmage Line
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Possession

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Possession, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents" }

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

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Possession, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]

YardsToEndzone

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.YardsToEndzone, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents", "value": 65 }

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.YardsToEndzone, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`value`	integer($int32)	Indicates yards to End Zone

MatchStatusChanged

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.MatchStatusChanged, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents", "matchStatus": "InProgress" }

Element

Type

Description

$type

string
[GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.MatchStatusChanged, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]

matchStatus

string($x-extensible-enum)

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

Indicates match status

PeriodChanged

Code Block
{ "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.PeriodChanged, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents" }

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

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.PeriodChanged, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]

Punt

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Punt, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": null,
  "isNullified": false,
  "players": [
    {
      "id": "1017141",
      "type": "Kicker"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Punt, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`yards`	integer($int32)	yards gained
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Risks

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Risks, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "touchdown": "NonActive",
  "onsideKick": "NonActive",
  "fieldGoal": "NonActive",
  "fourthDown": "NonActive",
  "safety": "NonActive",
  "challenge": "NonActive",
  "penalty": "NonActive",
  "videoReview": "NonActive",
  "turnover": "NonActive",
  "other": "Active",
  "playAboutToStart": "NonActive",
  "injury": "NonActive",
  "bigPlay": "Active",
  "statDelay": "NonActive"
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Risks, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`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
`injury`
`bigPlay`
`statDelay`

FairCatch

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.FairCatch, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": null,
  "isNullified": false,
  "yardLine": {
    "yards": 1,
    "sideOfPitch": "Away"
  },
  "players": [
    {
      "id": "1006701",
      "type": "Receiver"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.FairCatch, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`yards`	integer($int32)	yard line
`isNullified`	boolean	Indicates whether this action was nullified
`yardLine`	Yardlines array
`sideOfPitch`	string($x-extensible-enum) [ None, Home, Away ]	Indicates the side of the pitch if it’s home or away
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

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
`id`	integer($int32)
`name`	string

Other Match Events

Reliability

Code Block

{
  "$type": "Betgenius.Sports.Contracts.Common.MatchEvents.Reliability, Betgenius.Sports.Contracts.Common.MatchEvents",
  "utcTimestamp": "2024-07-16T08:26:01.350808Z",
  "isReliable": false,
  "reason": "Unreliable score"
}

Element	Type	Description
`$type`	string [Betgenius.Sports.Contracts.Common.MatchEvents.Reliability, Betgenius.Sports.Contracts.Common.MatchEvents]
`utcTimestamp`	string($date-time)	Timestamp of the message
`isReliable`	boolean	Indicates whether the current match events are reliable or not
`reason`	string	Reason

CurrentLineup

Code Block

 {
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.CurrentLineup, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "teamType": "Offensive",
  "players": [
    {
      "position": "RunningBack",
      "side": "Middle",
      "id": "796796",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "RunningBack",
      "side": "Middle",
      "id": "1076107",
      "name": null,
      "status": "Started"
    },
    {
      "position": "WideReceiver",
      "side": "Unknown",
      "id": "1003947",
      "name": null,
      "status": "Started"
    },
    {
      "position": "WideReceiver",
      "side": "Unknown",
      "id": "1014515",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "Quarterback",
      "side": "Middle",
      "id": "998871",
      "name": null,
      "status": "Started"
    },
    {
      "position": "WideReceiver",
      "side": "Unknown",
      "id": "1013138",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "Quarterback",
      "side": "Middle",
      "id": "578165",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "Tackle",
      "side": "Unknown",
      "id": "835944",
      "name": null,
      "status": "Started"
    },
    {
      "position": "WideReceiver",
      "side": "Unknown",
      "id": "1072641",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "TightEnd",
      "side": "Middle",
      "id": "835966",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "TightEnd",
      "side": "Middle",
      "id": "1014058",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "WideReceiver",
      "side": "Unknown",
      "id": "1072035",
      "name": null,
      "status": "Started"
    },
    {
      "position": "TightEnd",
      "side": "Middle",
      "id": "758163",
      "name": null,
      "status": "Started"
    },
    {
      "position": "OffensiveLineman",
      "side": "Unknown",
      "id": "1011755",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "Guard",
      "side": "Middle",
      "id": "1007857",
      "name": null,
      "status": "Started"
    },
    {
      "position": "Tackle",
      "side": "Unknown",
      "id": "1007535",
      "name": null,
      "status": "Started"
    },
    {
      "position": "Tackle",
      "side": "Unknown",
      "id": "1017075",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "OffensiveLineman",
      "side": "Unknown",
      "id": "1399022",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "Guard",
      "side": "Middle",
      "id": "1016344",
      "name": null,
      "status": "Started"
    },
    {
      "position": "Center",
      "side": "Middle",
      "id": "1013930",
      "name": null,
      "status": "Started"
    },
    {
      "position": "WideReceiver",
      "side": "Unknown",
      "id": "1398981",
      "name": null,
      "status": "Started"
    },
    {
      "position": "WideReceiver",
      "side": "Unknown",
      "id": "1343378",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "RunningBack",
      "side": "Middle",
      "id": "1016897",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "RunningBack",
      "side": "Middle",
      "id": "1007482",
      "name": null,
      "status": "Unknown"
    },
    {
      "position": "WideReceiver",
      "side": "Unknown",
      "id": "1007477",
      "name": null,
      "status": "Unknown"
    }
  ]
}

Element	Type	Description
`$type`	string [Betgenius.Sports.Contracts.Common.MatchEvents.Reliability, Betgenius.Sports.Contracts.Common.MatchEvents]
`teamType`	string [Unknown, Offensive, Defensive, Special]	Type of the team players are assigned to
`players`	Array Of Lineup Player	Lineup players array
`name`
`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

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Muff, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yardLine": {
    "yards": 1,
    "sideOfPitch": "Home"
  },
  "isNullified": false,
  "players": [
    {
      "id": "1013138",
      "type": "Muffed"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Muff, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`players`	Players array	Player data
`yards`	integer($int32)	yard line
`isNullified`	boolean	Indicates whether this action was nullified
`yardLine`	Yardlines array
`sideOfPitch`	string($x-extensible-enum) [ None, Home, Away ]	Indicates the side of the pitch if it’s home or away
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Recovery

Code Block

{
  "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Recovery, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
  "yards": 0,
  "yardLine": {
    "yards": 20,
    "sideOfPitch": "Home"
  },
  "isNullified": false,
  "players": [
    {
      "id": "1013138",
      "type": "Recoverer"
    }
  ]
}

Element	Type	Description
`$type`	string [GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Recovery, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]
`yards`	integer($int32)	Indicates the amount of yards from the point where opponents recovered the ball to the point where the play finished
`yardLine`	Yardlines array
`sideOfPitch`	string($x-extensible-enum) [ None, Home, Away ]	Indicates the side of the pitch if it’s home or away
`isNullified`	boolean	Indicates whether this action was nullified
`players`	Players array	Player data
`id`	integer($int32)	Unique player Id
`type`	string	Type of the player?

Players

Player type	Valid action types	Explanation
`Unknown`	`Penalty`	This action type is currently used in penalties
`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` `CompletePass` `IncompletePass` `Interception` `FairCatch` `TwoPointsConversion`	The player who is the intended receiver for a pass or fair catch. In case of conversions, only when pass is attempted
`Passer`	`PassAttempt` `CompletePass` `IncompletePass` `Interception` `TwoPointsConversion`	The player who passed the ball. In case of conversions, only when pass is attempted
`Fumbled`	`Fumble`	The player who fumbled the ball
`Recoverer`	`Recovery` `Fumble`	The player who recovered the ball
`Kicker`	`KickOff` `Punt` `FieldGoalAttempt` `FieldGoal` `FieldGoalBlocked` `OnePointConversion`	The play who kicked the ball.
`Runner`	`Run` `RunAfterCatch` `Kneel` `TwoPointsConversion`	The player who runs with the ball. In case of conversions, only 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`	`FieldGoalBlocked` `OnePointConversion` `Punt`	The player who blocks the kick
`QbHitter`	`PassAttempt` `CompletePass` `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 22	New Version 23
Changes made by	Iryna Antonova	Iryna Antonova
Saved on	Aug 01, 2024	Aug 01, 2024

Page Comparison

Versions Compared

Key

Feed Match Event

Feed Match Action

Actions

Fumble

PassAttempt (called Pass in v1)

IncompletePass

CompletePass

Interception

FieldGoal

FieldGoalAttempt

FieldGoalBlocked

TimeoutsRemaining

Timeout

Snap

Touchdown

Single

Run

RunAfterCatch

Kneel

Tackle

Comment

NextPlay

Safety

OnePointSafety

ClockSet

ClockStarted

ClockStopped

CoinToss

ConversionAttempt

OnePointConversion

TwoPointsConversion

OutOfBounds

Touchback

Penalty

Return

Down

Sack

KickOff

Possession

YardsToEndzone

MatchStatusChanged

PeriodChanged

Punt

Risks

FairCatch

Challenge

Lateral

Other Match Events

Reliability

CurrentLineup

Muff

Recovery

Players