Cricket data reference

← All sports

Generated from GET /v2/sports/27. Not hand-maintained - if the API adds a status or renames a statistic, this page follows on the next build.

Sport id: 27
Participants: 2
Match clock: no
Incident positions: no

Statuses 24

Every value event.status_id can take for this sport. Map onto this list rather than parsing status_type: ids are stable, labels are localized, and postponed matches keep status_type: scheduled.

id	Name	Short	Type	Notes
1	Not started	Sched.	scheduled	clock stoppedset by incident 427
5	Postponed	Post.	scheduled	clock stoppedset by incident 440TRAP: `status_type` is `scheduled`, exactly like a normal upcoming match. A postponed match is indistinguishable from a scheduled one unless you look at `status_id`. Never branch only on `status_type`.
6	Start delayed	Delay.	scheduled	clock stoppedset by incident 438
18	Live	live	live
66	After day 1	After 1 d.	live
67	After day 2	After 2 d.	live
68	After day 3	After 3 d.	live
69	After day 4	After 4 d.	live
152	To finish	To fin.	scheduled	clock stoppedset by incident 451TRAP: `status_type` is `scheduled`, but the match already started and was stopped - it is waiting to be finished on another date. Do not present it as an upcoming fixture.
247	1st innings home	1st innings - home	live
249	1st innings away	1st innings - away	live
251	2nd innings home	2nd innings - home	live
253	2nd innings away	2nd innings away	live
255	Super Over home	Super Over - home	live
256	Super Over Break	Super Over Break	live
257	Super Over away	Super Over - away	live
385	Innings break	Innings break	live
2	Interrupted	Interr.	interrupted	clock stoppedset by incident 441Play stopped and may resume. Incident 1001 (Match resumed) brings it back. Distinct from Abandoned (7), which may never resume.
3	Cancelled	Canc.	cancelled	clock stoppedset by incident 439
7	Abandoned	Abd.	interrupted	clock stoppedset by incident 442Play stopped and may never resume. Same `status_type` as Interrupted (2), so tell them apart by `status_id`.
11	Finished	Fin.	finished	clock stoppedset by incident 437One of FIVE terminal statuses (11, 12, 13, 14, 140). Treat every `status_type: finished` as terminal - checking for 11 alone misses matches decided in extra time, on penalties or in overtime.
12	Finished awarded win	AW	finished	clock stoppedset by incident 436Walkover: the result was awarded, not played out. Statistics and the timeline may be empty or not reflect play.
76	Retired	Ret.	finished
246	Finished after Super Over	Fin. after Super Over	finished

Results 14

Entries that can appear in participants[].results[], keyed by id. There is no score field - you select the result you need.

id	Name	Code	Type	Data type
411	Winner	winner	team	binary
412	Progress	progress	team	binary
2	Result	result	team	text
3	Regular time	regular_time	team	integer
570	First innings runs	first_inning_runs	team	integer
571	First innings wickets	first_inning_wickets	team	integer
574	Super Over runs	super_over	team	integer
575	Super Over wickets	super_over_wickets	team	integer
200	Wickets	wickets	team	integer
201	Overs	overs	team	integer
203	First to bat	first_to_bat	team	integer
1213	Current ball	current_ball	team	integer
1220	Current over	current_over	team	integer
1363	Super Over result	super_over_result	team	text

Event details 16

Per-match metadata in the event's details, with the input type and allowed values.

id	Name	Code	Input	Data type
149	Number of innings	number_of_innings	select	-
36	Pitch conditions	pitch_conditions_id	select	-
8	Weather conditions	weather_condition_id	select	-
141	Attendance	attendance	number	-
142	First innings home start date	first_inning_h_start_date	datetime	-
143	First innings away start date	first_inning_a_start_date	datetime	-
144	Second innings home start date	second_inning_h_start_date	datetime	-
148	Winning by	winning_by	select	-
205	Has lineups	has_lineups	select	-
235	Game end date	game_end_date	datetime	-
236	Event format	event_format_id	select	-
237	Maximum number of overs per bowler	maximum_number_of_overs_per_bowler	number	-
238	Toss winner	toss_winner	select	-
240	Reduced over	reduced_over	number	-
241	Revised target	revised_target	number	-
242	Revised overs	revised_overs	number	-

Incidents 96

Incident types that can appear in this sport's events_incidents. category: emergency marks operational notices, not match events - never render them on a timeline.

id	Name	Code	Type	Trader	Category	Notes
1701	1st innings home started	1st-innings-home-started	event	yes	standard
2846	The match will not be covered	the-match-will-not-be-covered	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The match will not be covered at all. The attribute gives the reason. Nothing further will arrive. Other: Scout's technical issues, Change of venue, Change of match date, Problems with TV transmission source
1702	1st innings away started	1st-innings-away-started	event	yes	standard
2847	Problems with the source of the broadcast	problems-with-the-source-of-the-broadcas	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The broadcast source has a problem. Paired with 2848 when it is solved.
2848	Problem with the source of the broadcast has been solved	problem-with-the-source-of-the-broadcast	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The broadcast source problem is solved.
2849	Change of coverage from venue to TV	change-of-coverage-from-venue-to-tv	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Before kick-off (`group: prematch`): moved from venue to TV.
1705	Super Over home started	super-over-home-started	event	yes	standard
2850	Change of coverage from TV to venue	change-of-coverage-from-tv-to-venue	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Before kick-off (`group: prematch`): moved from TV to venue.
1706	Super Over away started	super-over-away-started	event	yes	standard
2851	Change of coverage latency	change-of-coverage-latency	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Latency of the coverage changed. Relevant if you gate markets on feed delay. Other: from 3-6 to 7-15, from 7-15 to 3-6
2852	Scouting coverage can start with a delay of	scouting-coverage-can-start-with-a-delay	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Scouting coverage will start late. The attribute gives the size (under 3, 3-5 or 5-10 minutes). Other: < 3min, 3-5 min, 5-10 min
1708	Innings Break	innings-break	event	yes	standard
2853	Expected delay in the start of the match	expected-delay-in-the-start-of-the-match	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The match will start late. The attribute gives the reason - a team arriving late, problems in the stands and so on. Other: Delayed arrival of a team, Problems in the stands, Referee problems, Infrastructure problems, Weather conditions
2854	Team line-ups will not be available	team-line-ups-will-not-be-available	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Line-ups will not be available for this match. Do not wait for `lineups[]` to fill.
2855	Source of the coverage is delayed	source-of-the-coverage-is-delayed	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The coverage source is delayed. The attribute gives the size of the delay (about 5 to 20 seconds). Other: ~5sec, ~10sec, ~15sec, ~20sec, ~25sec, ~30sec, >30sec
2856	The current part of the game has started with a delay	the-current-part-of-the-game-has-started	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The current period started late.
2857	Verification of result in progress	verification-of-result-in-progress	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2858	Verification of result completed and correct	verification-of-result-completed-and-cor	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Verification of the result finished. Values are confirmed.
1713	Super Over Innings Break	super-over-innings-break	event	yes	standard
2859	Verification of key statistics is in progress	verification-of-key-statistics-is-in-pro	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2860	Verification of key statistics completed and correct	verification-of-key-statistics-completed	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Verification of key statistics finished. Values are confirmed.
2861	Verification of game clock is in progress	verification-of-game-clock-is-in-progres	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
807	Abandoned	abandoned	event	yes	standard
2862	Verification of game clock completed and correct	verification-of-game-clock-completed-and	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Verification of the game clock finished. Values are confirmed.
803	Cancelled	cancelled	event	yes	standard
2863	Match coverage interrupted due to technical issues	match-coverage-interrupted-due-to-techni	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Coverage stopped because of technical issues. 2864 or 2865 says whether it comes back.
1715	Finished	finished	event	yes	standard
2864	Match coverage will continue	match-coverage-will-continue	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Coverage will continue after the interruption.
1716	Finished after Super Over	finished-after-super-over	event	yes	standard
2865	Match coverage will not continue	match-coverage-will-not-continue	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Coverage will NOT continue. Expect no further incidents for this match.
802	Interrupted	interrupted	event	yes	standard
2866	The match is abandoned	the-match-is-abandoned	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The match was abandoned. The attribute gives the reason. Other: Problems in the stands, Referee problems, Infrastructure problems, Serious player injury, Weather conditions
805	Postponed	postponed	event	yes	standard
2867	Waiting for official decision regarding match resumption	waiting-for-official-decision-regarding-	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Waiting for an official decision on whether the match resumes. 2868 or 2869 follows.
2868	Match will resume shortly	match-will-resume-shortly	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The match resumes shortly.
806	Start Delayed	start-delayed	event	yes	standard
2869	Match will not resume	match-will-not-resume	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The match will not resume.
830	To finish	to-finish	event	yes	standard
2870	Expected delay in the start of the next part of the game	expected-delay-in-the-start-of-the-next-	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The next period will start late. The attribute gives the reason. Other: Problems in the stands, Referee problems, Infrastructure problems, Weather conditions
2871	Change of coverage from venue to TV	change-of-coverage-from-venue-to-tv-live	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. During play (`group: live`): moved from venue to TV.
2872	Change of coverage from TV to venue	change-of-coverage-from-tv-to-venue-live	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. During play (`group: live`): moved from TV to venue.
2873	Change of coverage latency	change-of-coverage-latency-live	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Coverage latency changed. The attribute gives the direction, for example from 3-6 to 7-15 seconds. Relevant if you gate markets on feed delay. Other: from 3-6 to 7-15, from 7-15 to 3-6
818	Live	live	event	no	standard
2874	Expected delay in the start of the match - safety reasons	expected-delay-in-the-start-of-the-match	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The match will start late for safety reasons.
801	Not started	not-started	event	yes	standard
2875	Verification of key statistics is in progress	verification-of-key-statistics-is-in-pro	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2876	Verification of key statistics completed and correct	verification-of-key-statistics-completed	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Verification of key statistics, after the match finished. Values are confirmed.
2877	Verification of player names for key incidents in progress	verification-of-names-for-key-incidents-	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2878	Verification of player names for key incidents completed and correct	verification-of-names-for-key-incidents-	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Verification of player names on key incidents finished. Values are confirmed.
2879	Verification of result is in progress	verification-of-result-is-in-progress	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
1783	Decision review	decision-review	event	yes	standard	Other: Retained, Lost
2880	Verification of result completed and correct	verification-of-result-completed-and-cor	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. Verification of the result, after the match finished. Values are confirmed.
2881	Problems with the low latency source of the coverage	problems-with-the-low-latency-source-of-	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The low-latency source has a problem. Paired with 2882.
819	After day 1	after-day-1	event	no	standard
2882	Problems with the low latency source of coverage has been solved	problems-with-the-low-latency-source-of-	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. The low-latency source problem is solved.
820	After day 2	after-day-2	event	no	standard
2883	Player name verification is in progress - substitution	player-name-verification-is-in-progress-	event	yes	emergency	emergencyOperational notice, not a match event - `category: emergency`. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
821	After day 3	after-day-3	event	no	standard
822	After day 4	after-day-4	event	no	standard
2739	Match about to start	match-about-to-start	event	yes	standard
2761	Break in play	break_in_play	event	yes	standard	Other: Rain, Injury, Bad light, Drinks, Tactical timeout, Other
1000	Betstart	betstart	event	yes	standard	marketBetting markets may be activated. Other: Master
1010	Betstop	betstop	event	yes	standard	marketAll betting markets are closed: a goal, penalty or red card looks likely, or the situation on the pitch is unclear. Other: Master
1001	Match resumed	match-resumed	event	yes	standard	informingUsed when an interrupted match resumes.
1200	Technical problems	technical-problems	event	yes	standard	marketTechnical problems during coverage. Closes all match markets automatically.
1756	Bowler running in	bowler-running-in	team	no	standard
1767	Possible Boundary	possible-boundary	team	yes	standard
1770	Possible wicket	possible-wicket	team	yes	standard
1717	Retired Hurt	retired-hurt	team	no	standard
1773	Dead ball	dead-ball	team	no	standard
1774	Free hit	free-hit	team	yes	standard
1775	One short	one-short	team	no	standard
1781	Extras - Penalty runs	extras-penalty-runs	team	yes	standard	Other: 1, 2, 3, 4, 5
1784	Batsman coming in	batsman-coming-in	team	no	standard
1785	Bowler change	bowler-change	team	no	standard
1786	Batsman retired	batsman-retired	team	no	standard
1788	Duckworth-Lewis method	duckworth-lewis-method	team	yes	standard
1792	Start of over	start-of-over	team	yes	standard
1791	End of over	end-of-over	team	yes	standard
2744	Dismissal - LBW	dismissal-lbw	team	yes	standard
2745	Dismissal - Caught	dismissal-caught	team	yes	standard
2746	Dismissal - Bowled	dismissal-bowled	team	yes	standard
2747	Dismissal - Run out	dismissal-run-out	team	yes	standard
2748	Dismissal - Stumped	dismissal-stumped	team	yes	standard
2749	Dismissal - Hit wicket	dismissal-hit-wicket	team	yes	standard
2750	Dismissal - Handled the ball	dismissal-handled-the-ball	team	yes	standard
2751	Dismissal - Obstructing the Field	dismissal-obstructing-the-Field	team	yes	standard
2752	Dismissal - Hit the ball twice	dismissal-hit-the-ball-twice	team	yes	standard
2754	Out	out	team	yes	standard
2755	Legal Ball	legal_ball	team	yes	standard	Other: Runs, Boundary 4, Boundary 6, Byes, Leg Byes, Wicket, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
2756	Illegal Ball	illegal_ball	team	yes	standard	Other: Wide, No ball, No ball + Bat, Wicket, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
2757	Timed out	timed_out	team	yes	standard
2758	Penalty	penalty	team	yes	standard	Other: Player returning without permission, Fielding the ball illegally, Ball in play hitting helmet, Match ball changing condition unfairly, Deliberate distraction of batsman, Deliberate attempt to distract striker, Time wasting by fielding side, Fielder causing damage to pitch, Failing to bowl overs in give time, Batsman stealing a run, Deliberate short run, Batsman wasting time, Batsman causing damage to pitch
2759	Toss won	toss_won	team	yes	standard
2760	Batting team	batting_team	team	yes	standard
2921	Substitution	substitution	team	yes	standard

Standings types 9

Values for type_name on /v2/standings. Pick the one you need and match its columns by code, not by position.

id	Name
87	Away standings
27	Form table
86	Home standings
88	League standings
44	Most popular results
60	Overall stats
52	Streaks
94	Team overall stats
89	Wide standings

Statistics 64

Split into team statistics (in participants[].stats) and person statistics (in sub_participants[].stats). Match by code, not by position.

Team 27

id	Name	Code	Data type
569	Runs	runs	integer
582	Current over runs	current_over_runs	integer
583	1st ball	first_ball	text
584	2nd ball	second_ball	text
585	3rd ball	third_ball	text
586	4th ball	fourth_ball	text
587	5th ball	fifth_ball	text
588	6th ball	sixth_ball	text
1238	Batting team	batting_team	binary
1241	7th ball	seventh_ball	text
1242	8th ball	eighth_ball	text
1243	9th ball	ninth_ball	text
1244	10th ball	tenth_ball	text
1245	11th ball	eleventh_ball	text
1246	12th ball	twelfth_ball	text
1313	Current action	current_action	integer
1362	Super Over Overs	super_over_overs	integer
1445	Extra Runs	extra_runs	integer
1446	Leg Byes	leg_byes	integer
1447	Byes	byes	integer
1448	Wides	wides	integer
1449	No Ball	no_ball	integer
576	Number of overs	number_of_overs	decimal
577	Number of Boundaries - 4	number_of_boundaries_4	integer
578	Number of over Boundaries - 6	number_of_over_boundaries_6	integer
579	Number of wickets	number_of_wickets	integer
581	Number of balls in current over	number_of_balls	integer

Person 37

id	Name	Code	Data type
582	Current over runs	current_over_runs	integer
583	1st ball	first_ball	text
584	2nd ball	second_ball	text
585	3rd ball	third_ball	text
586	4th ball	fourth_ball	text
587	5th ball	fifth_ball	text
588	6th ball	sixth_ball	text
35	Appearance	appearance	binary
1239	Will not play	will_not_play	binary
1241	7th ball	seventh_ball	text
1242	8th ball	eighth_ball	text
1243	9th ball	ninth_ball	text
1244	10th ball	tenth_ball	text
1245	11th ball	eleventh_ball	text
1246	12th ball	twelfth_ball	text
1444	Current batter	current_batter	binary
1443	Current bowler	current_bowler	binary
1450	Individual Batter Score	individual_batter_score	integer
1451	Batter Scored 50	batter_scored_50	binary
1452	Batter Scored 100	batter_scored_100	binary
1453	Balls Faced	balls_faced	integer
1454	Batter Strike Rate	batter_strike_rate	integer
1455	Number of Balls Bowled	number_of_balls_bowled	integer
1456	Runs Conceded by the Bowler	runs_conceded_by_the_bowler	integer
1457	Wickets Taken by the Bowler	wickets_taken_by_the_bowler	integer
1458	Maiden Over (M)	maiden_over	integer
1459	Number of Dot Balls	number_of_dot_balls	integer
1460	Number of Boundary 4 Conceded	number_of_boundary_4_conceded	integer
1461	Number of Boundary 6 Conceded	number_of_boundary_6_conceded	integer
1462	Wide Ball Bowled (wd)	wide_ball_bowled	integer
1463	No Ball Bowled (Nb)	no_ball_bowled	integer
1464	Man Of The Match	man_of_the_match	binary
576	Number of overs	number_of_overs	decimal
577	Number of Boundaries - 4	number_of_boundaries_4	integer
578	Number of over Boundaries - 6	number_of_over_boundaries_6	integer
580	Striking rate	striking_rate	integer
581	Number of balls in current over	number_of_balls	integer