Cricket a match API
A matchOne match in full, finished or in play.
Ask for it by our id, taken from any other cricket answer. The ids inside the answer each open their own endpoint, so you can follow a record from here to everything it links to.
It needs id. Leave one out and the answer names it, before any data is read.
Try it
Your key stays in this browser and is filled in on every docs page.
200 OK150 ms1 recordReal answer from 2026-11-03, trimmed
{
"data": {
"match": "ck_nkqf0zm4cy",
"name": "Queensland v Victoria",
"competition": "Sheffield Shield",
"format": "First-class",
"state": "live",
"international": false,
"women": false,
"status": "Queensland require 169 runs",
"starts_at": "2026-10-31T00:00:00Z",
"venue": "Brisbane Cricket Ground, Woolloongabba, Brisbane",
"city": "Brisbane",
"teams": [
{
"name": "Queensland",
"score": "280 & 32/1 (12 ov, target 201)"
},
{
"name": "Victoria",
"score": "307 & 173"
}
],
"innings": [
{
"innings": 1,
"team": "Victoria",
"runs": 307,
"wickets": 10,
"overs": "90.4",
"chase_target": null,
"innings_declared": false
},
{
"innings": 2,
"team": "Victoria",
"runs": 0,
"wickets": 0,
"overs": "103.5",
"chase_target": null,
"innings_declared": false
},
{
"innings": 3,
"team": "Victoria",
"runs": 173,
"wickets": 10,
"overs": "78.2",
"chase_target": null,
"innings_declared": false
}
],
"ball_by_ball": true,
"batting": "Victoria",
"winner": null,
"updated_at": "2026-11-03T04:23:06Z",
"toss": "Queensland , elected to field first",
"scorecard": [
{
"innings": 1,
"team": "Victoria",
"runs": 307,
"wickets": 10,
"overs": "90.4",
"run_rate": 3.39,
"extras": 14,
"extras_detail": {
"no_balls": 3,
"byes": 4,
"leg_byes": 7
},
"batting": [
{
"player": "ck_trnga2mqgd",
"name": "Sam Harper",
"runs": 63,
"balls": 89,
"fours": 9,
"sixes": 1,
"out": true,
"how_out": "bowled",
"dismissal": "b Cameron Gannon",
"strike_rate": 70.8
},
{
"player": "ck_rfaeaed9c5",
"name": "Marcus Harris",
"runs": 56,
"balls": 122,
"fours": 9,
"sixes": 0,
"out": true,
"how_out": "caught",
"dismissal": "c Hugh Weibgen b Jem Ryan",
"strike_rate": 45.9
},
{
"player": "ck_4pnkmwakwv",
"name": "Campbell Kellaway",
"runs": 64,
"balls": 156,
"fours": 6,
"sixes": 0,
"out": true,
"how_out": "caught",
"dismissal": "c Jimmy Peirson b Cameron Gannon",
"strike_rate": 41
}
],
"bowling": [
{
"player": "ck_pqv3dj2kcx",
"name": "Cameron Gannon",
"overs": "22",
"maidens": 10,
"runs": 66,
"wickets": 5,
"economy": 3,
"dots": 106,
"fours": 10,
"sixes": 1,
"wides": 0,
"no_balls": 0
},
{
"player": "ck_v1sxp5hggq",
"name": "Jem Ryan",
"overs": "19",
"maidens": 3,
"runs": 64,
"wickets": 3,
"economy": 3.37,
"dots": 87,
"fours": 9,
"sixes": 0,
"wides": 0,
"no_balls": 2
},
{
"player": "ck_yakgttwwqt",
"name": "Hayden Kerr",
"overs": "16",
"maidens": 3,
"runs": 51,
"wickets": 0,
"economy": 3.19,
"dots": 74,
"fours": 8,
"sixes": 0,
"wides": 0,
"no_balls": 1
}
]
},
{
"innings": 2,
"team": "Victoria",
"runs": 280,
"wickets": 10,
"overs": "103.5",
"run_rate": 2.7,
"extras": 14,
"extras_detail": {
"wides": 8,
"byes": 5,
"leg_byes": 1
},
"batting": [
{
"player": "ck_hqd4pk8fw3",
"name": "Hugh Weibgen",
"runs": 20,
"balls": 36,
"fours": 3,
"sixes": 0,
"out": true,
"how_out": "bowled",
"dismissal": "b Will Sutherland",
"strike_rate": 55.6
},
{
"player": "ck_2gasdat8je",
"name": "Angus Lovell",
"runs": 36,
"balls": 117,
"fours": 6,
"sixes": 0,
"out": true,
"how_out": "leg before wicket",
"dismissal": "leg before wicket",
"strike_rate": 30.8
},
{
"player": "ck_2ngd27qjsv",
"name": "Hugo Burdon",
"runs": 2,
"balls": 5,
"fours": 0,
"sixes": 0,
"out": true,
"how_out": "caught",
"dismissal": "c Marcus Harris b Will Sutherland",
"strike_rate": 40
}
],
"bowling": [
{
"player": "ck_0j03apmpkr",
"name": "Fergus O'Neill",
"overs": "18",
"maidens": 9,
"runs": 29,
"wickets": 0,
"economy": 1.61,
"dots": 96,
"fours": 5,
"sixes": 0,
"wides": 0,
"no_balls": 0
},
{
"player": "ck_8gq72tp0ga",
"name": "Mitchell Perry",
"overs": "19",
"maidens": 2,
"runs": 68,
"wickets": 1,
"economy": 3.58,
"dots": 83,
"fours": 9,
"sixes": 0,
"wides": 0,
"no_balls": 0
},
{
"player": "ck_w8j9hp019y",
"name": "Will Sutherland",
"overs": "21.5",
"maidens": 4,
"runs": 68,
"wickets": 3,
"economy": 3.11,
"dots": 97,
"fours": 5,
"sixes": 0,
"wides": 6,
"no_balls": 0
}
]
},
{
"innings": 3,
"team": "Victoria",
"runs": 173,
"wickets": 10,
"overs": "78.2",
"run_rate": 2.21,
"extras": 10,
"extras_detail": {
"no_balls": 3,
"byes": 1,
"leg_byes": 6
},
"batting": [
{
"player": "ck_trnga2mqgd",
"name": "Sam Harper",
"runs": 6,
"balls": 14,
"fours": 1,
"sixes": 0,
"out": true,
"how_out": "caught",
"dismissal": "c Hugo Burdon b Jem Ryan",
"strike_rate": 42.9
},
{
"player": "ck_rfaeaed9c5",
"name": "Marcus Harris",
"runs": 9,
"balls": 12,
"fours": 2,
"sixes": 0,
"out": true,
"how_out": "bowled",
"dismissal": "b Jem Ryan",
"strike_rate": 75
},
{
"player": "ck_4pnkmwakwv",
"name": "Campbell Kellaway",
"runs": 35,
"balls": 122,
"fours": 2,
"sixes": 0,
"out": true,
"how_out": "caught",
"dismissal": "c Hugh Weibgen b Mitchell Swepson",
"strike_rate": 28.7
}
],
"bowling": [
{
"player": "ck_pqv3dj2kcx",
"name": "Cameron Gannon",
"overs": "16",
"maidens": 6,
"runs": 25,
"wickets": 2,
"economy": 1.56,
"dots": 83,
"fours": 3,
"sixes": 0,
"wides": 0,
"no_balls": 0
},
{
"player": "ck_v1sxp5hggq",
"name": "Jem Ryan",
"overs": "14",
"maidens": 4,
"runs": 38,
"wickets": 3,
"economy": 2.71,
"dots": 68,
"fours": 5,
"sixes": 0,
"wides": 0,
"no_balls": 3
},
{
"player": "ck_yakgttwwqt",
"name": "Hayden Kerr",
"overs": "13",
"maidens": 7,
"runs": 23,
"wickets": 2,
"economy": 1.77,
"dots": 67,
"fours": 2,
"sixes": 0,
"wides": 0,
"no_balls": 0
}
]
}
],
"now": {
"innings": 4,
"batting": [
{
"player": "ck_2ngd27qjsv",
"name": "Hugo Burdon",
"runs": 8,
"balls": 19,
"fours": 1,
"sixes": 0,
"strike_rate": 42.1,
"on_strike": true
},
{
"player": "ck_2gasdat8je",
"name": "Angus Lovell",
"runs": 14,
"balls": 41,
"fours": 2,
"sixes": 0,
"strike_rate": 34.1,
"on_strike": false
}
],
"bowler": {
"player": "ck_8gq72tp0ga",
"name": "Mitchell Perry",
"overs": "6",
"maidens": 2,
"runs": 10,
"wickets": 1,
"economy": 1.67
},
"over": {
"over": 12,
"ball": 6
},
"last_overs": [
{
"over": 10,
"bowler": "Mitchell Perry",
"balls": [
".",
".",
"."
],
"runs": 0
},
{
"over": 11,
"bowler": "Will Sutherland",
"balls": [
".",
"1",
"2"
],
"runs": 7
},
{
"over": 12,
"bowler": "Mitchell Perry",
"balls": [
"1",
".",
"."
],
"runs": 1
}
],
"partnership": {
"runs": 14,
"balls": 28
},
"run_rate": 2.74,
"recent": [
".",
"1",
"2"
],
"chase": {
"target": 201,
"need": 169
}
},
"last_ball": "Y2RiOmxiNDAxMTA2"
},
"meta": {
"sport": "cricket",
"endpoint": "/matches/{id}",
"cached": false,
"age_seconds": 0
}
}No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.
Parameters
Query values this call takes. Anything else is refused with bad_param and the list it accepts.
| Name | Type | What it does | |
|---|---|---|---|
| id | id | required | The record, by our id, in the path. |
Returns
Each field in data, from a real answer. Every id is ours and opens its own endpoint.
| Field | Type | What it holds |
|---|---|---|
| match | string | The match, by our id |
| name | string | Its name |
| competition | string | The competition |
| format | string | The format |
| state | string | State |
| international | boolean | International |
| women | boolean | Women |
| status | string | Its state: scheduled, live, finished or similar |
| starts_at | datetime | Start time |
| venue | string | The venue |
| city | string | The city |
| teams | list | Both sides, with their scores |
| innings | list | Each innings |
| ball_by_ball | boolean | Ball by ball |
| batting | string | Batting |
| winner | null | Who won |
| updated_at | datetime | When it last changed |
| toss | string | Toss |
| scorecard | list | Scorecard |
| now | object | Now |
| last_ball | string | Last ball |
| meta | What it holds |
|---|---|
| sport, endpoint | What you asked |
| count | Rows in this answer |
| page, per_page, total, next_cursor | Where you are in a paged list, when it is paged |
| as_of | When the data was built |
| cached, age_seconds | Whether this is a stored copy, and its age |
| access | On the free key: what it reads, and the plan that opens the rest |
Errors
Codes this call can give. Each is explained in Errors.
| Status | Code | When |
|---|---|---|
| 401 | no_key | No key sent, or not in a form we read |
| 401 | bad_key | A key we do not know |
| 403 | plan | The free key asked for a date other than yesterday |
| 404 | not_found | An id we never issued for cricket |
| 422 | bad_param | A value this call does not take, or a required one missing |
| 429 | rate | Over the calls a minute for your plan |
| 503 | upstream | The data is not answering; retry after Retry-After |
The free key reads yesterday. The Cricket plan opens live, fixtures and every date held, for $49 a month.
Add Cricket