Cricket live scores API
Live scoresMatches in play, ball by ball.
Live returns every cricket match in play right now. The answer is kept for 10 seconds, so asking every 10 to 15 seconds keeps a scoreboard current. An empty list means nothing is in play. Live comes with the Cricket plan.
Try it
Your key stays in this browser and is filled in on every docs page.
200 OK2303 ms2 rows shownReal 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:21:15Z"
},
{
"match": "ck_wd13gkjg7t",
"name": "Sylhet Division v Chattogram Division",
"competition": "National Cricket League",
"format": "First-class",
"state": "live",
"international": false,
"women": false,
"status": "Chattogram require 101 runs",
"starts_at": "2026-10-31T03:30:00Z",
"venue": "Bir Sreshtho Flight Lieutenant Matiur Rahman Stadium, Chattogram",
"city": "Chattogram",
"teams": [
{
"name": "Sylhet Division",
"score": "218 & 218"
},
{
"name": "Chattogram Division",
"score": "210 & 126/1 (37 ov, target 227)"
}
],
"innings": [
{
"innings": 1,
"team": "Chattogram Division",
"runs": 0,
"wickets": 0,
"overs": "72.3",
"chase_target": null,
"innings_declared": false
},
{
"innings": 2,
"team": "Chattogram Division",
"runs": 210,
"wickets": 10,
"overs": "60.1",
"chase_target": null,
"innings_declared": false
},
{
"innings": 3,
"team": "Chattogram Division",
"runs": 0,
"wickets": 0,
"overs": "85.5",
"chase_target": null,
"innings_declared": false
}
],
"ball_by_ball": true,
"batting": "Chattogram Division",
"winner": null,
"updated_at": "2026-11-03T04:21:09Z"
}
],
"meta": {
"sport": "cricket",
"endpoint": "/live",
"count": 24,
"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 | |
|---|---|---|---|
| competition | id | optional | Only this competition, by its id from Competitions. |
Returns
Each row of 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 |
| 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, or a sport you do not hold |
| 422 | bad_param | A value this call does not take |
| 429 | rate | Over the calls a minute for your plan |
| 503 | upstream | The data is not answering; retry after Retry-After |
Live scores comes with the Cricket plan, $49 a month, with every date held and 250,000 calls a month.
Add Cricket