Ball By Ball API
Provides all details about balls of requested over. If the over key is not provided with request, response will have 1st over of 1st innings.
Request
- Path:
https://rest.cricketapi.com/rest/v2/match/{MATCH_KEY}/balls/{OVER_KEY}/ - Method:
GET -
URL Params:
MATCH_KEY: Key of the matchOVER_KEY: {TEAM_KEY} _ {INNINGS_KEY} _ {OVER_NUMBER}INNINGS_KEY: Key of the innings, possible values are 1,2 and superoverTEAM_KEY: Match team key, possible values are 'a' and 'b'.OVER_NUMBER: Over number starts from 1.
-
Params:
access_token- Required
Response
data.pre_over- Key for the previous over.data.next_over- Key for the next over.data.over- Over details.data.balls- Requested Over balls.
Default Ball By Ball Sample Request & Response
Request
$ GET https://rest.cricketapi.com/rest/v2/match/sltriseriest20_2018_final/balls/?access_token=ACCESSTOKEN
Response
{
"status": true,
"version": "2.0.3",
"status_code": 200,
"expires": "1543499519.0",
"Etag": "1543499519.0",
"cache_key": "match|asiacup_2018_final|balls",
"data": {
"next_over": "b_1_2",
"balls": {
"203a82a7-b33b-4b9b-870e-3f6bc6fa78df": {
"comment": "Bhuvneshwar Kumar to Mehidy Hasan: No runs.",
"wicket_type": "",
"over": 1,
"ball_type": "normal",
"highlight_names_keys": [
[
"over_end",
"meh_hasan"
]
],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:33:40.151000",
"ball": "6",
"batsman": {
"runs": 0,
"dotball": 1,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "meh_hasan"
},
"striker": "meh_hasan",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "l_das",
"runs": 0,
"bowler": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"key": "b_kumar",
"wicket": 0
},
"over_str": "0.6",
"extras": "0",
"team": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"c9ecb1a5-6b3d-42f8-b80c-d6f728599167": {
"comment": "Bhuvneshwar Kumar to Mehidy Hasan: 1 run.",
"wicket_type": "",
"over": 1,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:31:32.426000",
"ball": "2",
"batsman": {
"runs": 1,
"dotball": 0,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "meh_hasan"
},
"striker": "meh_hasan",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "l_das",
"runs": 1,
"bowler": {
"runs": 1,
"extras": 0,
"ball_count": 1,
"key": "b_kumar",
"wicket": 0
},
"over_str": "0.2",
"extras": "0",
"team": {
"runs": 1,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"84569cce-7648-4ed1-b86a-878457f90b3e": {
"comment": "Bhuvneshwar Kumar to Liton Das: 1 run.",
"wicket_type": "",
"over": 1,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:31:24.436000",
"ball": "1",
"batsman": {
"runs": 1,
"dotball": 0,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "l_das"
},
"striker": "l_das",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "meh_hasan",
"runs": 1,
"bowler": {
"runs": 1,
"extras": 0,
"ball_count": 1,
"key": "b_kumar",
"wicket": 0
},
"over_str": "0.1",
"extras": "0",
"team": {
"runs": 1,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"c229bac2-27db-407f-a633-3cf20938cff7": {
"comment": "Bhuvneshwar Kumar to Liton Das: No runs.",
"wicket_type": "",
"over": 1,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:32:01.909000",
"ball": "3",
"batsman": {
"runs": 0,
"dotball": 1,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "l_das"
},
"striker": "l_das",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "meh_hasan",
"runs": 0,
"bowler": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"key": "b_kumar",
"wicket": 0
},
"over_str": "0.3",
"extras": "0",
"team": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"1a9887f8-c467-40d0-915c-f7cfe0a121b0": {
"comment": "Bhuvneshwar Kumar to Liton Das: 1 run.",
"wicket_type": "",
"over": 1,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:32:38.185000",
"ball": "4",
"batsman": {
"runs": 1,
"dotball": 0,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "l_das"
},
"striker": "l_das",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "meh_hasan",
"runs": 1,
"bowler": {
"runs": 1,
"extras": 0,
"ball_count": 1,
"key": "b_kumar",
"wicket": 0
},
"over_str": "0.4",
"extras": "0",
"team": {
"runs": 1,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"59d0caa4-6eb6-4ceb-8209-a04f62b99695": {
"comment": "Bhuvneshwar Kumar to Mehidy Hasan: No runs.",
"wicket_type": "",
"over": 1,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:33:07.566000",
"ball": "5",
"batsman": {
"runs": 0,
"dotball": 1,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "meh_hasan"
},
"striker": "meh_hasan",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "l_das",
"runs": 0,
"bowler": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"key": "b_kumar",
"wicket": 0
},
"over_str": "0.5",
"extras": "0",
"team": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
}
},
"over": {
"innings": 1,
"over": 1,
"balls": [
"84569cce-7648-4ed1-b86a-878457f90b3e",
"c9ecb1a5-6b3d-42f8-b80c-d6f728599167",
"c229bac2-27db-407f-a633-3cf20938cff7",
"1a9887f8-c467-40d0-915c-f7cfe0a121b0",
"59d0caa4-6eb6-4ceb-8209-a04f62b99695",
"203a82a7-b33b-4b9b-870e-3f6bc6fa78df"
],
"team": "b"
},
"expires": "1543499519.0",
"pre_over": null,
"match": {
"status": "completed",
"data_review_checkpoint": "post-match-validated",
"status_overview": "result"
}
}
}
Innings Wise Ball By Ball Sample Request & Response
Request
$ GET https://rest.cricketapi.com/rest/v2/match/sltriseriest20_2018_final/balls/b_1_2/?access_token=ACCESSTOKEN
Response
{
"status": true,
"version": "2.0.3",
"status_code": 200,
"expires": "1543499580.0",
"Etag": "1543499580.0",
"cache_key": "match|asiacup_2018_final|balls_b_1_2",
"data": {
"next_over": "b_1_3",
"balls": {
"afc3f3f0-b255-4481-9db5-b9530dc2d038": {
"comment": "JJ Bumrah to Mehidy Hasan: No runs.",
"wicket_type": "",
"over": 2,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:36:24.916000",
"ball": "3",
"batsman": {
"runs": 0,
"dotball": 1,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "meh_hasan"
},
"striker": "meh_hasan",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "l_das",
"runs": 0,
"bowler": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"key": "j_bumrah",
"wicket": 0
},
"over_str": "1.3",
"extras": "0",
"team": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"dc0c0242-0767-4196-8c92-f9cd0eaca2eb": {
"comment": "JJ Bumrah to Mehidy Hasan: <b>FOUR</b>.",
"wicket_type": "",
"over": 2,
"ball_type": "normal",
"highlight_names_keys": [
[
"player_four",
"meh_hasan"
]
],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:37:01.710000",
"ball": "4",
"batsman": {
"runs": 4,
"dotball": 0,
"six": 0,
"four": 1,
"ball_count": 1,
"key": "meh_hasan"
},
"striker": "meh_hasan",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "l_das",
"runs": 4,
"bowler": {
"runs": 4,
"extras": 0,
"ball_count": 1,
"key": "j_bumrah",
"wicket": 0
},
"over_str": "1.4",
"extras": "0",
"team": {
"runs": 4,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"d6b66570-a9c4-4cac-8420-9da44c949f26": {
"comment": "JJ Bumrah to Mehidy Hasan: No runs.",
"wicket_type": "",
"over": 2,
"ball_type": "normal",
"highlight_names_keys": [
[
"over_end",
"meh_hasan"
]
],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:38:16.180000",
"ball": "6",
"batsman": {
"runs": 0,
"dotball": 1,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "meh_hasan"
},
"striker": "meh_hasan",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "l_das",
"runs": 0,
"bowler": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"key": "j_bumrah",
"wicket": 0
},
"over_str": "1.6",
"extras": "0",
"team": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"f4e64147-739f-4598-abe5-ca13af2d2f33": {
"comment": "JJ Bumrah to Mehidy Hasan: No runs.",
"wicket_type": "",
"over": 2,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:35:47.646000",
"ball": "2",
"batsman": {
"runs": 0,
"dotball": 1,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "meh_hasan"
},
"striker": "meh_hasan",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "l_das",
"runs": 0,
"bowler": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"key": "j_bumrah",
"wicket": 0
},
"over_str": "1.2",
"extras": "0",
"team": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"d4cc94aa-0359-4630-a682-380932f4a61e": {
"comment": "JJ Bumrah to Mehidy Hasan: No runs.",
"wicket_type": "",
"over": 2,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:37:40.678000",
"ball": "5",
"batsman": {
"runs": 0,
"dotball": 1,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "meh_hasan"
},
"striker": "meh_hasan",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "l_das",
"runs": 0,
"bowler": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"key": "j_bumrah",
"wicket": 0
},
"over_str": "1.5",
"extras": "0",
"team": {
"runs": 0,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
},
"88b8d516-8917-4133-8054-89a0aabaddf5": {
"comment": "JJ Bumrah to Liton Das: 1 run.",
"wicket_type": "",
"over": 2,
"ball_type": "normal",
"highlight_names_keys": [],
"innings": "1",
"wagon_position": null,
"decision_by": null,
"wicket": "",
"match": "asiacup_2018_final",
"status": "played",
"updated": "2018-09-28T11:35:10.606000",
"ball": "1",
"batsman": {
"runs": 1,
"dotball": 0,
"six": 0,
"four": 0,
"ball_count": 1,
"key": "l_das"
},
"striker": "l_das",
"batting_team": "b",
"other_fielder": null,
"fielder": {},
"nonstriker": "meh_hasan",
"runs": 1,
"bowler": {
"runs": 1,
"extras": 0,
"ball_count": 1,
"key": "j_bumrah",
"wicket": 0
},
"over_str": "1.1",
"extras": "0",
"team": {
"runs": 1,
"extras": 0,
"ball_count": 1,
"wicket": 0
}
}
},
"over": {
"innings": 1,
"over": 2,
"balls": [
"88b8d516-8917-4133-8054-89a0aabaddf5",
"f4e64147-739f-4598-abe5-ca13af2d2f33",
"afc3f3f0-b255-4481-9db5-b9530dc2d038",
"dc0c0242-0767-4196-8c92-f9cd0eaca2eb",
"d4cc94aa-0359-4630-a682-380932f4a61e",
"d6b66570-a9c4-4cac-8420-9da44c949f26"
],
"team": "b"
},
"expires": "1543499580.0",
"pre_over": "b_1_1",
"match": {
"status": "completed",
"data_review_checkpoint": "post-match-validated",
"status_overview": "result"
}
}
}
