⏱️
Update Frequency
10s Time To Live / Cache

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`sport_event` - `tournament` - `category`	String	Country code for a tournament's category
`id`	`sport_event` - `tournament` - `category`	String	Unique category ID for a tournament ex. `sr:category:105`
`name`	`sport_event` - `tournament` - `category`	String	Name for a tournament's category ex. `International`
`id`	`sport_event` - `tournament` - `sport`	String	Unique sport ID for a tournament ex. `sr:sport:21`
`name`	`sport_event` - `tournament` - `sport`	String	Name for a tournament's sport ex. `Cricket`

Season

Attribute	Parent Element	Type	Description
`end_date`	`sport_event` - `season`	Date	End date of a sport event's season ex. `2024-06-17`
`id`	`sport_event` - `season`	String	Unique ID for a sport event's season ex. `sr:season:122977` (Sheffield Shield 24/25)
`name`	`sport_event` - `season`	String	Name of a sport event's season ex. `Sheffield Shield 24/25`
`start_date`	`sport_event` - `season`	Date	Start date of a sport event's season ex. `2023-09-23`
`tournament_id`	`sport_event` - `season`	String	Unique tournament ID for a sport event's season ex. `sr:tournament:21568` (Sheffield Shield)
`year`	`sport_event` - `season`	String	Year of a sport event's season ex. `23/24` or `2024`

Tournament

Attribute	Parent Element	Type	Description
`gender`	`sport_event` - `tournament`	String	Gender of a sport event's tournament `men`, `women`, `mixed`
`id`	`sport_event` - `tournament`	String	Unique ID for a sport event's tournament ex. `sr:tournament:21568` (Sheffield Shield)
`name`	`sport_event` - `tournament`	String	Name of a sport event's tournament ex. `Sheffield Shield`
`type`	`sport_event` - `tournament`	String	Type of a sport event's tournament `test`, `odi`, `t10`, `t20i`, `first_class`, `list_a`, `t20`, `the_hundred`
`name`	`sport_event` - `tournament_round`	String	Name of a sport event's tournament round
`number`	`sport_event` - `tournament_round`	Integer	Number of a sport event's tournament round
`type`	`sport_event` - `tournament_round`	String	Type of a sport event's tournament round ex. `group`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `team`	String	Abbreviation for a competitor name ex. `BUL` (Queensland Bulls)
`country`	`competitors` - `team`	String	Country of a competitor ex. `Australia`
`country_code`	`competitors` - `team`	String	Country code of a competitor ex. `AUS` (Australia)
`gender`	`competitors` - `team`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `team`	String	Unique ID for a competitor ex. `sr:competitor:142678` (Queensland Bulls)
`name`	`competitors` - `team`	String	Name for a competitor ex. `Queensland Bulls`
`qualifier`	`competitors` - `team`	String	Designation of a competitor for a sport event `home`, `away`
`virtual`	`competitors` - `team`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Player

Attribute	Parent Element	Type	Description
`id`	`player`	String	Unique ID of a player ex. `sr:player:696896`
`name`	`player`	String	Name of a player ex. `Sarkar, Soumya`

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:52962997`
`scheduled`	`sport_event`	Date-time	Scheduled start time of a match ex. `2025-02-08T00:00:00+00:00`
`start_time_tbd`	`sport_event`	Boolean	Signifies the start time of a match is TBD when `true`
`status`	`sport_event`	String	Status of a match. See our FAQ for a complete list of statuses and their definitions

Sport Event Conditions

Attribute	Parent Element	Type	Description
`day_night`	`sport_event_conditions`	String	Signifies a day or night match `day`, `night`
`neutral_venue`	`sport_event_conditions`	Boolean	Signifies a match is played at a neutral site when `true`
`type`	`sport_event_conditions`	String	Type of a match `test`, `odi`, `t10`, `t20i`, `first_class`, `list_a`, `t20`
`rain_conditions`	`sport_event_conditions` - `weather_info`	String	Rain conditions for a match `no_rain`, `expected_soon`, `showers`, `rain`, `heavy_rain`, `unknown`
`sky_conditions`	`sport_event_conditions` - `weather_info`	String	Sky conditions for a match `clear`, `partly_cloudy`, `cloudy`, `overcast`, `unknown`
`temperature_range`	`sport_event_conditions` - `weather_info`	String	Temperature range for a match `very_hot`, `hot`, `warm`, `mild`, `cold`, `very_cold`, `unknown`
`wind_conditions`	`sport_event_conditions` - `weather_info`	String	Wind conditions for a match `no_wind`, `breeze`, `windy`, `gale`, `unknown`
`boundary_position`	`sport_event_conditions` - `pitch_info`	String	Boundary position of the pitch for a match `in`, `normal`, `unknown`
`grass_cover`	`sport_event_conditions` - `pitch_info`	String	Grass cover of the pitch for a match `barren`, `normal`, `green`, `unknown`
`pitch_moisture`	`sport_event_conditions` - `pitch_info`	String	Moisture of the pitch for a match `very_dry`, `dry`, `normal`, `moist`, `unknown`
`pitch_quality`	`sport_event_conditions` - `pitch_info`	String	Quality of the pitch for a match `normal`, `delayed`, `deteriorating`, `slow`, `low`, `unknown`
`outfield_conditions`	`sport_event_conditions` - `outfield_info`	String	Outfield conditions for a match `slow`, `normal`, `fast`

Sport Event - Coverage Properties

Attribute	Parent Element	Type	Description
`type`	`coverage`	String	Type of coverage `sport_event`
`level`	`coverage` - `sport_event_property`	String	Coverage level for a match. See our FAQ for detailed descriptions of each level `post`, `core`, `advanced`, `fielding`

Period Scores

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away team inning score
`allotted_overs`	`sport_event_status` - `period_scores` - `period_score`	Integer	Number of allotted overs for an inning
`away_wickets`	`sport_event_status` - `period_scores` - `period_score`	Integer	Number of away wickets in an inning
`display_overs`	`sport_event_status` - `period_scores` - `period_score`	Float	Number of overs for an inning ex. `33.3`
`display_score`	`sport_event_status` - `period_scores` - `period_score`	String	Display score for an inning ex. `144/10`
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home team inning score
`home_wickets`	`sport_event_status` - `period_scores` - `period_score`	Integer	Number of home wickets in an inning
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Inning number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type ex. `inning`

Sport Event Status

Attribute	Parent Element	Type	Description
`allotted_overs`	`sport_event_status`	Integer	Number of allotted overs for the current inning
`current_inning`	`sport_event_status`	Integer	Current inning of a match
`current_session`	`sport_event_status`	Integer	Current session of a match
`display_overs`	`sport_event_status`	Float	Number of overs for the current inning ex. `33.3`
`display_score`	`sport_event_status`	String	Display score for the current inning ex. `144/10`
`match_result_text`	`sport_event_status`	String	Text description of the result of a match ex. `Oval Invincibles won by 6 wickets` or `London Spirit won by 17 runs`
`match_status`	`sport_event_status`	String	Status within a match (sport event). Provides more detail on the state of a match when live than `status` ex. `first_innings_away`, `stumps`, `ended`, `tea_break` See our FAQ for a complete list of statuses
`required_run_rate`	`sport_event_status`	Float	The run rate the batting side must achieve in order to win a match ex. `20.222`
`run_rate`	`sport_event_status`	Float	Current run rate of the batting side ex. `4.3`
`status`	`sport_event_status`	String	Status of a match ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions
`toss_decision`	`sport_event_status`	String	Decision of the team winning the toss ex. `bat`, `bowl`
`toss_won_by`	`sport_event_status`	String	Unique ID of the team which won the toss ex. `sr:competitor:142710`
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:142704`

Match Stats - Inning

Attribute	Parent Element	Type	Description
`batting_team`	`statistics` - `inning`	String	Unique ID of the batting team in an inning ex. `sr:competitor:142710`
`bowling_team`	`statistics` - `inning`	String	Unique ID of the bowling team in an inning ex. `sr:competitor:107203`
`number`	`statistics` - `inning`	Integer	Number of an inning
`overs_completed`	`statistics` - `inning`	Integer	Number of overs completed in an inning

Match Stats - Batting (Team)

Attribute	Parent Element	Type	Description
`balls_remaining`	`inning` - `team` - `statistics` - `batting`	Integer	Number of balls remaining in an inning for a batting team
`fours`	`inning` - `team` - `statistics` - `batting`	Integer	Number of fours in an inning for a batting team
`overs_remaining`	`inning` - `team` - `statistics` - `batting`	Integer	Number of overs remaining in an inning for a batting team
`penalty_runs`	`inning` - `team` - `statistics` - `batting`	Integer	Number of penalty runs in an inning for a batting team
`reviews_remaining`	`inning` - `team` - `statistics` - `batting`	Integer	Number of reviews remaining in an inning for a batting team
`run_rate`	`inning` - `team` - `statistics` - `batting`	Float	Run rate of the batting team in an inning ex. `4.3`
`runs`	`inning` - `team` - `statistics` - `batting`	Integer	Number of runs in an inning for a batting team
`sixes`	`inning` - `team` - `statistics` - `batting`	Integer	Number of sixes in an inning for a batting team
`wickets_lost`	`inning` - `team` - `statistics` - `batting`	Integer	Number of wickets lost in an inning for a batting team

Match Stats - Bowling (Team)

Attribute	Parent Element	Type	Description
`byes`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of byes in an inning for a bowling team
`dot_balls`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of dot balls in an inning for a bowling team
`bowling_extras`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of extras in an inning for a bowling team
`leg_byes`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of leg byes in an inning for a bowling team
`maidens`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of maidens in an inning for a bowling team
`overs`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of overs in an inning for a bowling team
`bowling_reviews_remaining`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of reviews remaining in an inning for a bowling team
`wickets`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of wickets in an inning for a bowling team
`wides`	`inning` - `team` - `statistics` - `bowling`	Integer	Number of wides in an inning for a bowling team

Match Stats - Bowling Spell

Attribute	Parent Element	Type	Description
`spell_order`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Integer	Spell order for a bowling team
`start`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Float	Display score at the beginning of a bowling spell
`start_time`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Date-time	Timestamp of the start of a bowling spell ex. `2024-08-04T14:11:19.994Z`
`end`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Float	Display score of a bowling spell
`end_time`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Date-time	Timestamp of the end of a bowling spell ex. `2024-08-04T14:11:19.994Z`
`conceded_runs`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Integer	Number of conceded runs for a bowling spell
`dot_balls`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Integer	Number of dot balls for a bowling spell
`economy_rate`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Float	Economy rate for a bowling spell ex. `3.3`
`maidens`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Integer	Number of maidens for a bowling spell
`no_balls`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Integer	Number of no-balls for a bowling spell
`overs_bowled`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Integer	Number of overs bowled for a bowling spell
`wickets`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Integer	Number of wickets for a bowling spell
`wides`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell`	Integer	Number of wides for a bowling spell
`name`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell` - `player`	String	Bowler name for a bowling spell
`id`	`inning` - `team` - `statistics` - `bowling` - `bowling_spell` - `player`	String	Unique ID for the bowler of a bowling spell ex. `sr:player:1984093`

Match Stats - Batting Partnerships

Attribute	Parent Element	Type	Description
`balls_faced`	`inning` - `team` - `statistics` - `batting` - `partnership`	Integer	Number of balls faced for a batting partnership in an inning
`dismissed_player`	`inning` - `team` - `statistics` - `batting` - `partnership`	String	Unique ID of a dismissed player from a batting partnership in an inning
`end`	`inning` - `team` - `statistics` - `batting` - `partnership`	Float	Display score for a batting partnership
`end_time`	`inning` - `team` - `statistics` - `batting` - `partnership`	Date-time	Timestamp of the end of a partnership end ex. `2024-08-04T14:11:19.994Z`
`overs`	`inning` - `team` - `statistics` - `batting` - `partnership`	Integer	Number of overs for a batting partnership in an inning
`runs`	`inning` - `team` - `statistics` - `batting` - `partnership`	Integer	Number of runs scored for a batting partnership in an inning
`runs_extras`	`inning` - `team` - `statistics` - `batting` - `partnership`	Integer	Number of runs scored from extras for a batting partnership in an inning
`start`	`inning` - `team` - `statistics` - `batting` - `partnership`	Float	Display score at the beginning of a batting partnership
`start_time`	`inning` - `team` - `statistics` - `batting` - `partnership`	Date-time	Timestamp of the start of a partnership end ex. `2024-08-04T14:11:19.994Z`
`wicket_number`	`inning` - `team` - `statistics` - `batting` - `partnership`	Integer	Wicket number for a batting partnership in an inning

Match Stats - Batting Partnerships (Player)

Attribute	Parent Element	Type	Description
`balls_faced`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Number of balls faced for a batting partner in a partnership
`dot_balls`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Number of dot balls for a batting partner in a partnership
`fours`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Number of fours for a batting partner in a partnership
`ones`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Number of ones for a batting partner in a partnership
`order`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Order number for a batting partner in an inning
`runs`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Number of total runs for a batting partner in a partnership
`sixes`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Number of sixes for a batting partner in a partnership
`status`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	String	Status of a batting partner in a partnership `OUT`, `NOT_OUT`, `RETIRED`
`strike_rate`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Float	Strike rate for a batting partner in a partnership
`threes`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Number of threes for a batting partner in a partnership
`twos`	`inning` - `team` - `statistics` - `batting` - `partnership` - `player`	Integer	Number of twos for a batting partner in a partnership

Match Stats - Batting (Player)

Attribute	Parent Element	Type	Description
`balls_faced`	`team` - `batting` - `player` - `statistics`	Integer	Number of balls faced by a batter in an inning
`dot_balls`	`team` - `batting` - `player` - `statistics`	Integer	Number of dot balls by a batter in an inning
`fours`	`team` - `batting` - `player` - `statistics`	Integer	Number of fours by a batter in an inning
`minutes_at_crease`	`team` - `batting` - `player` - `statistics`	Integer	Number of minutes at the crease by a batter in an inning
`ones`	`team` - `batting` - `player` - `statistics`	Integer	Number of ones by a batter in an inning
`order`	`team` - `batting` - `player` - `statistics`	Integer	Order number for a batter in an inning
`runs`	`team` - `batting` - `player` - `statistics`	Integer	Number of runs scored by a batter in an inning
`shots_attacking`	`team` - `batting` - `player` - `statistics`	Integer	Number of attacking shots by a batter in an inning
`sixes`	`team` - `batting` - `player` - `statistics`	Integer	Number of sixes by a batter in an inning
`strike_rate`	`team` - `batting` - `player` - `statistics`	Float	Strike rate for a batter in an inning ex. `73.68`
`threes`	`team` - `batting` - `player` - `statistics`	Integer	Number of threes by a batter in an inning
`twos`	`team` - `batting` - `player` - `statistics`	Integer	Number of twos by a batter in an inning
`ball_number`	`team` - `batting` - `player` - `statistics` - `dismissal`	Integer	Ball number for a batter's dismissal
`bowler_id`	`team` - `batting` - `player` - `statistics` - `dismissal`	String	Unique player ID for the bowler on pitch for a batter's dismissal
`over_number`	`team` - `batting` - `player` - `statistics` - `dismissal`	Integer	Over number for a batter's dismissal
`type`	`team` - `batting` - `player` - `statistics` - `dismissal`	String	Type of a batter's dismissal `unknown`, `caught`, `leg_before_wicket`, `bowled`, `stumped`, `run_out`, `hit_wicket`, `retired_hurt`, `hit_twice`, `timed_out`, `handled_ball`, `obstructing_field`, `retired`, `retired_not_out`, `absent`

Match Stats - Bowling (Player)

Attribute	Parent Element	Type	Description
`appeals`	`team` - `bowling` - `player` - `statistics`	Integer	Number of appeals for a bowler in an inning
`around_the_wicket`	`team` - `bowling` - `player` - `statistics`	Integer	Number of around the wickets for a bowler in an inning
`conceded_runs`	`team` - `bowling` - `player` - `statistics`	Integer	Number of runs conceded for a bowler in an inning
`dot_balls`	`team` - `bowling` - `player` - `statistics`	Integer	Number of dot balls for a bowler in an inning
`economy_rate`	`team` - `bowling` - `player` - `statistics`	Float	Economy rate for a bowler in an inning
`edges`	`team` - `bowling` - `player` - `statistics`	Integer	Number of edges for a bowler in an inning
`maidens`	`team` - `bowling` - `player` - `statistics`	Integer	Number of maidens for a bowler in an inning
`no_balls`	`team` - `bowling` - `player` - `statistics`	Integer	Number of no-balls for a bowler in an inning
`order`	`team` - `bowling` - `player` - `statistics`	Integer	Order number for a bowler in an inning
`over_the_wicket`	`team` - `bowling` - `player` - `statistics`	Integer	Number of over the wickets for a bowler in an inning
`overs_bowled`	`team` - `bowling` - `player` - `statistics`	Integer	Number of overs bowled for a bowler in an inning
`wickets`	`team` - `bowling` - `player` - `statistics`	Integer	Number of wickets for a bowler in an inning
`wides`	`team` - `bowling` - `player` - `statistics`	Integer	Number of wides for a bowler in an inning

Timeline - Event

Attribute	Parent Element	Type	Description
`ball_number`	`event`	Integer	Ball number for a timeline event
`display_overs`	`event`	Float	Number of overs for a timeline event ex. `33.3`
`display_score`	`event`	String	Display score for a timeline event ex. `144/10`
`id`	`event`	String	Unique ID of a timeline event ex. `1810898191`
`inning`	`event`	Integer	Inning number of a timeline event
`over_number`	`event`	Integer	Over number of a timeline event
`period_name`	`event`	String	Name of a period. See the Cricket OpenAPI spec for a complete list of period names ex. `Drinks`, `First innings, home team`
`time`	`event`	Date-time	Timestamp of a timeline event ex. `2024-04-16T20:49:49+00:00`
`type`	`event`	String	Type of timeline event ex. `ball`, `period_start`, `wicket`
`text`	`event` - `commentary`	String	Commentary for a timeline event ex. `Full, on a good line. Kuldeep Yadav gets forward and plays a defensive stroke`

Timeline - Batting Parameters

Attribute	Parent Element	Type	Description
`angle_traversed`	`event` - `batting_params`	Integer	The directional angle of the ball. Number of degrees (clockwise) where the top is 0. ex. `354`
`connect`	`event` - `batting_params`	String	Type of hit for a batter `good`, `poor`, `play_miss`, `inside_edge`, `outside_edge`, `hit_gloves`
`hit_to_boundary`	`event` - `batting_params`	Boolean	Signifies a ball was hit to the boundary when `true`
`runs_scored`	`event` - `batting_params`	Integer	Number of runs scored for a timeline event
`shot_type`	`event` - `batting_params`	String	Shot type for a timeline event `defensive`, `leave`, `padded`, `cut`, `late_cut`, `square_cut`, `pull`, `hook`, `drive`, `glance`, `leg_glance`, `ramp`, `sweep`, `reverse_sweep`, `switch_hit`, `paddle`, `flick`, `scoop`
`zone_played_in`	`event` - `batting_params`	String	Zone a ball was played in for a timeline event `square_leg`, `fine_leg`, `third_man`, `point`, `cover`, `mid_off`, `mid_on`, `mid_wicket`
`id`	`event` - `batting_params` - `striker`	String	Unique player ID of a striker for a timeline event ex. `sr:player:729354`
`name`	`event` - `batting_params` - `striker`	String	Player name of a striker for a timeline event ex. `Chameera, Dushmantha`
`country_code`	`event` - `batting_params` - `striker`	String	Player country code of a striker for a timeline event ex. `LKA` (Sri Lanka)
`id`	`event` - `batting_params` - `non_striker`	String	Unique player ID of a non-striker for a timeline event ex. `sr:player:729354`
`name`	`event` - `batting_params` - `non_striker`	String	Player name of a non-striker for a timeline event ex. `Chameera, Dushmantha`
`country_code`	`event` - `batting_params` - `non_striker`	String	Player country code of a non-striker for a timeline event ex. `LKA` (Sri Lanka)

Timeline - Bowling Parameters

Attribute	Parent Element	Type	Description
`beat_bat`	`event` - `bowling_params`	Boolean	Signifies a beat bat was used in a timeline event when `true`
`bowling_end`	`event` - `bowling_params`	String	Bowling end for a timeline event ex. `scoreboard_end`, `khettarama_end`
`bowling_from`	`event` - `bowling_params`	String	Describes whether a bowler is bowling over or around the wicket for a timeline event `over`, `around`
`delivery_type`	`event` - `bowling_params`	String	Delivery type for a bowler in a timeline event `stock`, `slower`, `variation`, `wrong_un`
`extra_runs_conceded`	`event` - `bowling_params`	Integer	Number of extra runs conceded by a bowler in a timeline event
`extra_runs_type`	`event` - `bowling_params`	String	Type of extra runs conceded by a bowler in a timeline event `no_ball`, `wide`, `bye`, `leg_bye`, `no_ball_bye`, `no_ball_leg_bye`
`pitch_x`	`event` - `bowling_params`	Integer	x coordinate where the ball was pitched
`pitch_y`	`event` - `bowling_params`	Integer	y coordinate where the ball was pitched
`id`	`event` - `bowling_params` - `bowler`	String	Unique player ID of a bowler for a timeline event ex. `sr:player:729354`
`name`	`event` - `bowling_params` - `bowler`	String	Player name of a bowler for a timeline event ex. `Chameera, Dushmantha`
`country_code`	`event` - `bowling_params` - `bowler`	String	Player country code of a bowler for a timeline event ex. `LKA` (Sri Lanka)

Timeline - Dismissal Parameters

Attribute	Parent Element	Type	Description
`type`	`event` - `dismissal_params` - `dismissal_details`	String	Type of dismissal for a timeline event `caught`, `leg_before_wicket`, `bowled`, `stumped`, `run_out`, `hit_wicket`, `retired_hurt`, `hit_twice`, `timed_out`, `handled_ball`, `obstructing_field`, `retired`, `retired_not_out`, `absent`
`bowler_id`	`event` - `dismissal_params` - `dismissal_details`	String	Bowler ID for a dismissal event ex. `sr:player:1021233`
`fielder_id`	`event` - `dismissal_params` - `dismissal_details`	String	Fielder ID for a dismissal event ex. `sr:player:1021233`
`decision_reason`	`event` - `dismissal_params` - `dismissal_details`	String	Decision reason for a dismissal event `no_contact_with_ball`, `batsman_knicked_ball`, `too_high`, `too_wide`, `hit_in_line_with_stumps`, `hit_outside_line_of_stumps`, `ball_height`, `bastman_forward`, `bowler_overstepped`, `bowler_not_overstepped`, `batsman_safe`, `batsman_short_of_crease`, `benefit_of_doubt`

Timeline - Fielding Parameters

Attribute	Parent Element	Type	Description
`catch_dropped`	`event` - `fielding_params`	Boolean	Signifies a catch was dropped when `true`
`difficulty_rating`	`event` - `fielding_params`	Integer	Scout's opinion on fielding difficulty. Range is 1-5, with 5 the most difficult.
`fielded`	`event` - `fielding_params`	Boolean	Signifies a ball was fielded when `true`
`fielded_wicket_keeper`	`event` - `fielding_params`	Boolean	Signifies a ball was fielded by a wicket-keeper when `true`
`misfielded`	`event` - `fielding_params`	Boolean	Signifies a ball was mis-fielded when `true`
`overthrows`	`event` - `fielding_params`	Integer	Number of overthrows for a timeline event
`pressure_applied`	`event` - `fielding_params`	Boolean	Signifies fielding pressure was applied on a ball when `true`
`run_out_missed`	`event` - `fielding_params`	Boolean	Signifies a run out throw missed when `true`
`runs_saved`	`event` - `fielding_params`	Integer	Number of runs saved on a ball
`stumping_missed`	`event` - `fielding_params`	Boolean	Signifies a stumping was missed on a ball when `true`

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `22500`
`city_name`	`venue`	String	City name of a venue ex. `Sylhet`
`country_code`	`venue`	String	Country code of a venue ex. `BGD` (Bangladesh)
`country_name`	`venue`	String	Country name of a venue ex. `Bangladesh`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:24744`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `24.920781,91.868653`
`name`	`venue`	String	Name of a venue ex. `Sylhet International Cricket Stadium`
`timezone`	`venue`	String	Timezone of a venue ex. `Asia/Kolkata`
`state`	`venue`	String	State of a venue ex. `Sylhet International Cricket Stadium`
`name`	`venue` - `bowling_end`	String	Name of a venue bowling end ex. `Anna Pavilion End`, `V Pattabhiraman Gate End`