get https://api.sportradar.com/cricket-t2//matches//timeline.
Provides real-time match-level statistics and a play-by-play event timeline for a given match. This includes player and team stats, scoring info, batting and bowling parameters, and human-readable event descriptions. Please note that data returned is determined by coverage level.
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 tournamentmen, 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 ex. test, odi, t10, t20i, first_class, list_a, t20 |
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 competitormale, 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 eventhome, away |
virtual | competitors - team | Boolean | Signifies a competitor is a virtual team whan 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 matchday, 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 matchtest, odi, t10, t20i, first_class, list_a, t20 |
rain_conditions | sport_event_conditions - weather_info | String | Rain conditions for a matchno_rain, expected_soon, showers, rain, heavy_rain, unknown |
sky_conditions | sport_event_conditions - weather_info | String | Sky conditions for a matchclear, partly_cloudy, cloudy, overcast, unknown |
temperature_range | sport_event_conditions - weather_info | String | Temperature range for a matchvery_hot, hot, warm, mild, cold, very_cold, unknown |
wind_conditions | sport_event_conditions - weather_info | String | Wind conditions for a matchno_wind, breeze, windy, gale, unknown |
boundary_position | sport_event_conditions - pitch_info | String | Boundary position of the pitch for a matchin, normal, unknown |
grass_cover | sport_event_conditions - pitch_info | String | Grass cover of the pitch for a matchbarren, normal, green, unknown |
pitch_moisture | sport_event_conditions - pitch_info | String | Moisture of the pitch for a matchvery_dry, dry, normal, moist, unknown |
pitch_quality | sport_event_conditions - pitch_info | String | Quality of the pitch for a matchnormal, delayed, deteriorating, slow, low, unknown |
outfield_conditions | sport_event_conditions - outfield_info | String | Outfield conditions for a matchslow, normal, fast |
Sport Event - Coverage Properties:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
type | coverage | String | Type of coveragesport_event |
level | coverage - sport_event_property | String | Coverage level for a match. See our FAQ for a detailed descriptions of each levelpost, 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_status | sport_event_status | String | Status within a match (sport event). Provides more detail on the state of a match when live than statusex. first_innings_away, stumps, ended, tea_breakSee 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, closedSee our FAQ for a complete list of statuses and their definitions |
toss_decision | sport_event_status | Float | 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 partnershipOUT, 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 |
over_number | team - batting - player - statistics - dismissal | String | Type of a batter's dismissalunknown, 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 battergood, 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 eventdefensive, 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 eventsquare_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 eventover, around |
delivery_type | event - bowling_params | String | Delivery type for a bowler in a timeline eventstock, 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 eventno_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 eventcaught, 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 eventno_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 |