⏱️
Update Frequency
60s Time To Live / Cache

Data Points

Game Probabilities

Attribute	Parent Element	Type	Description
`name`	`market`	String	Probability market `2way`
`name`	`market` - `outcome`	String	Probability market outcome `home_team_winner`, `away_team_winner`
`probability`	`market` - `outcome`	Float	Probability of the market outcome (home win, away win) in percentage ex. `36.1`

Category & Sport

| Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- || | country_code | sport_event_context - category | String | Country code for a sport event's category

ex. CAN (Canada) | | id | sport_event_context - category | String | Unique category ID for a sport event

ex. sr:category:93 | | name | sport_event_context - category | String | Name for a sport event's category

ex. Canada | | id | sport_event_context - sport | String | Unique sport ID for a sport event

sr:sport:16 | | name | sport_event_context - sport | String | Name for a sport event's sport

American Football |

Competition

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition `men`, `women`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:790` (CFL)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `CFL`, `NFL`, `NCAA`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions ex. `sr:competition:850` used to group NCAA postseason tournaments.

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:83021` (NFL 24/25, NFC North)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `NFL 24/25`, `NFL 24/25, NFC`, `NFL 24/25, NFC North`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `NFC North`

Rounds

Attribute	Parent Element	Type	Description
`competition_sport_event_number`	`sport_event_context` - `round`	Integer	Sport event number within a competition. Used for competitions that have fixed match numbers.
`cup_round_id`	`sport_event_context` - `round`	String	Unique ID for a sport event's cup round ex. `sr:cup_round:1751367`
`cup_round_number_of_sport_events`	`sport_event_context` - `round`	Integer	Number of events in a sport event's round
`cup_round_sport_event_number`	`sport_event_context` - `round`	Integer	Number within the `cup_round` of a match ID. For example, 1st leg of 2
`name`	`sport_event_context` - `round`	String	Name of a sport event's round ex. `american_football_conference_championship` or `super_bowl`
`number`	`sport_event_context` - `round`	Integer	Number of a sport event's round
`other_sport_event_id`	`sport_event_context` - `round`	String	A linked sport event ID, typically in a two-legged tie ex. `sr:sport_event:47395897`

Seasons

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a sport event belongs to ex. `sr:competition:31` (NFL)
`disabled`	`sport_event_context` - `season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`sport_event_context` - `season`	Date	End date of a sport event's season ex. `2024-02-11`
`id`	`sport_event_context` - `season`	String	Unique ID for a sport event's season ex. `sr:season:108577` (NFL 23/24)
`name`	`sport_event_context` - `season`	String	Name of a sport event's season ex. `NFL 23/24`
`start_date`	`sport_event_context` - `season`	Date	Start date of a sport event's season ex. `2023-09-07`
`year`	`sport_event_context` - `season`	String	Year of a sport event's season ex. `23/24`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-02-11`
`order`	`sport_event_context` - `stage`	Integer	Order of a stage within a season
`phase`	`sport_event_context` - `stage`	String	Name of a sport event's stage ex. `regular season`, `conference`, `playoffs` See the enum_phase entry in our Global American Football OpenAPI spec for a complete list of valid `phase` enum values
`start_date`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2024-01-13`
`type`	`sport_event_context` - `stage`	String	Type of a sport event's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a sport event's stage ex. `23/24`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `DEN` (Denver Broncos)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `USA`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `USA` (United States))
`division`	`competitors` - `competitor`	Integer	Division number for a competitor
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - competitor`	String	Unique ID for a competitor ex. `sr:competitor:4418` (Denver Broncos)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Denver Broncos`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`
`state`	`competitors` - `competitor`	String	State of a competitor ex. `CO` (Colorado)
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Sport Event

Attribute	Parent Element	Type	Description
`neutral`	`sport_event_conditions` - `ground`	Boolean	Signifies a neutral ground sport event when `true`
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:46791659`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:46791659`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`

Sport Event - Coverage Properties

Attribute	Parent Element	Type	Description
`live`	`sport_event` - `coverage`	Boolean	Signifies a sport event is covered live when `true`

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `76125`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_name`	`venue`	String	City name of a venue ex. `Denver`
`country_code`	`venue`	String	Country code of a venue ex. `USA` (United States)
`country_name`	`venue`	String	Country name of a venue ex. `USA`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:8179`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `39.743865,-105.020158`
`name`	`venue`	String	Name of a venue ex. `Empower Field at Mile High`
`reduced_capacity`	`venue`	Boolean	Optional attribute signifying a venue has a restricted capacity when `true`
`reduced_capacity_max`	`venue`	Integer	Value of a venue's restricted capacity
`timezone`	`venue`	String	Timezone of a competitor's home venue ex. `America/Denver`