American Football Match EventsV2

1 Feed Match Event
- 1.1 American Football Match Events
2 Feed Match Action
3 Actions
- 3.1 Fumble
- 3.2 PassAttempt (called Pass in v1)
- 3.3 IncompletePass
- 3.4 CompletePass
- 3.5 Interception
- 3.6 FieldGoal
- 3.7 FieldGoalAttempt
- 3.8 FieldGoalBlocked
- 3.9 TimeoutsRemaining
- 3.10 Timeout
- 3.11 Snap
- 3.12 Touchdown
- 3.13 Single
- 3.14 Run
- 3.15 RunAfterCatch
- 3.16 Kneel
- 3.17 Tackle
- 3.18 Comment
- 3.19 NextPlay
- 3.20 Safety
- 3.21 OnePointSafety
- 3.22 ClockSet
- 3.23 ClockStarted
- 3.24 ClockStopped
- 3.25 CoinToss
- 3.26 ConversionAttempt
- 3.27 OnePointConversion
- 3.28 TwoPointsConversion
- 3.29 OutOfBounds
- 3.30 Touchback
- 3.31 Penalty
- 3.32 Return
- 3.33 Down
- 3.34 Sack
- 3.35 KickOff
- 3.36 Possession
- 3.37 YardsToEndzone
- 3.38 MatchStatusChanged
- 3.39 PeriodChanged
- 3.40 Punt
- 3.41 Risks
- 3.42 FairCatch
- 3.43 Challenge
- 3.44 Lateral
4 Other Match Events
- 4.1 Reliability
- 4.2 CurrentLineup
- 4.3 Muff
- 4.4 Recovery
5 Players

Feed Match Event

American Football Match Events

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

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

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

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

{
  "team": "Home",
  "gameTime": "00:10:00",
  "period": {
    "number": 1,
    "progressStatus": "NotStarted",
    "type": "Regular"
  },
  "utcTimestamp": "2023-09-24T18:19:09.5924521Z"
}

Element	Type	Description

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

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

Fumble

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

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)

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

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

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

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

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

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

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

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

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

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

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

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

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

Element	Type	Description

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

TimeoutsRemaining

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

Element	Type	Description

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

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

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

Snap

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

Element	Type	Description

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

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

Element	Type	Description

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

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

Element	Type	Description

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

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

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

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

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

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

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

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

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

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

Element	Type	Description

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

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

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

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

Element	Type	Description

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

OnePointSafety

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

Element	Type	Description

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

ClockSet

{
}

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

ClockStarted

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

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

ClockStopped

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

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

CoinToss

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

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

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

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

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

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

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

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

"action": {
            "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.OutOfBounds, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
            "yards": null,
            "yardLine": {
                "yards": 21,
                "sideOfPitch": "Home"
            },
            "isNullified": false,
            "players": [],
            "team": "Home",
            "gameTime": "00:00:00",
            "period": null,
            "utcTimestamp": "2024-08-02T01:04:29.5609949Z"
        },
        "messageTimestampUtc": "2024-08-02T01:04:30.1486946Z"
    },

Element	Type	Description

Element

Type

Description

$type

string

[GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.OutOfBounds, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents]

yards

integer($int32)

Indicates the yard line where out of bounds happened

players

Players array

Player data

Touchback

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

Element	Type	Description

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

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

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

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

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

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

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

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

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

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

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

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

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

YardsToEndzone

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

Element	Type	Description

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

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

Element	Type	Description

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

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

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

Punt

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

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

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

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

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

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

"action": {
            "$type": "GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents.Challenge, GeniusSports.Sports.AmericanFootball.Contracts.V2.MatchEvents",
            "playId": "782",
            "rulingOnField": null,
            "type": "TeamChallenge",
            "result": "Unknown",
            "outcome": "Unknown",
            "team": "None",
            "gameTime": "00:06:40",
            "period": null,
            "utcTimestamp": "2024-08-10T00:20:04.4691164Z"
        },
        "messageTimestampUtc": "2024-08-10T00:20:08.1573096Z"
    },

Element	Type	Description

Element

Type

Description

result

string($x-extensible-enum)

[ Unknown, Won, Lost ]

Result of the challenge

Lateral

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

Element	Type	Description

Element	Type	Description
`yards`	integer($int32)	Indicates how many yards was the lateral.
`players`	Players array	Player data, indicates who lateraled (passer) and who received the lateral (receiver)
`isNullified`	boolean	Indicates whether this action was nullified
`id`	integer($int32)
`name`	string

Other Match Events

Reliability

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

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

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

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

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

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

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

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

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

American Football Match EventsV2

Feed Match Event