Fantasy points
On each planFree keyLast 30 daysMatch WeekLast 30 daysArchiveLast 30 daysProLast 30 daysAnalyst ProIn fullMCP toolfantasy_match_points
Every player's fantasy points in a match held card by card (2001 on), by side, highest first: the total, batting, bowling, fielding and playing points, and every item they came from with its count (runs, fours, sixes, milestones, strike rate, wickets, bowled or lbw, hauls, maidens, dots, economy, catches, stumpings, run outs).
GET
https://api.cricketdatabase.com/v1/fantasy/matches/{match}/pointsTry it
Kept in this browser and filled in on every docs page.
Parameters
| Name | Type | Required | Description | Values |
|---|---|---|---|---|
match | string | yes | In the address: the match's address name | 2026-09-17-sri-lanka-v-england |
rules | string | no | A JSON object over the default rules, such as {"wkt":30,"catch":10}; see /v1/fantasy/rules |
Returns
| Field | Type | What it holds |
|---|---|---|
data | object | |
data.match | string | The match's address name, for /v1/matches/{match} |
data.date | string | The first day of the match |
data.format | string | test, odi, t20i, t20, multi-day or one-day |
data.gender | string | male or female |
data.family | string | |
data.rules | string | |
data.result | string | The result in words |
data.teams[] | array | Each side in the match: team, name, total, players |
data.teams[].players[].player | string | A player's address name |
data.teams[].players[].name | string | The name as shown |
data.teams[].players[].team | string | A side's address name |
data.teams[].players[].role | string | |
data.teams[].players[].total | number | Items in all, with these filters |
data.teams[].players[].batting | number | |
data.teams[].players[].bowling | number | |
data.teams[].players[].fielding | number | |
data.teams[].players[].playing | number | |
data.teams[].players[].items[] | array | part, item, count, points |
meta | object | |
meta.plan | string | The plan the key is on |
Example answer
A real answer for /v1/fantasy/matches/2026-09-17-sri-lanka-v-england/points, lists cut to their first two items.
{
"data": {
"match": "2026-09-17-sri-lanka-v-england",
"date": "2026-09-17",
"format": "t20i",
"gender": "male",
"family": "t20",
"rules": "default",
"result": "England won by 6 wickets",
"teams": [
{
"team": "england",
"name": "England",
"total": 616,
"players": [
{
"player": "la-dawson",
"name": "LA Dawson",
"team": "england",
"role": "allrounder",
"total": 107,
"batting": 0,
"bowling": 87,
"fielding": 16,
"playing": 4,
"items": [
{
"part": "playing",
"item": "in the eleven",
"count": 1,
"points": 4
},
{
"part": "bowling",
"item": "wickets",
"count": 3,
"points": 75
},
"... 3 more"
]
},
{
"player": "j-overton",
"name": "J Overton",
"team": "england",
"role": "allrounder",
"total": 91,
"batting": 0,
"bowling": 71,
"fielding": 16,
"playing": 4,
"items": [
{
"part": "playing",
"item": "in the eleven",
"count": 1,
"points": 4
},
{
"part": "bowling",
"item": "wickets",
"count": 2,
"points": 50
},
"... 4 more"
]
},
"... 9 more"
]
},
{
"team": "sri-lanka",
"name": "Sri Lanka",
"total": 341,
"players": [
{
"player": "pwh-de-silva",
"name": "PWH de Silva",
"team": "sri-lanka",
"role": "allrounder",
"total": 66,
"batting": 31,
"bowling": 23,
"fielding": 8,
"playing": 4,
"items": [
{
"part": "playing",
"item": "in the eleven",
"count": 1,
"points": 4
},
{
"part": "batting",
"item": "runs",
"count": 27,
"points": 27
},
"... 6 more"
]
},
{
"player": "p-nissanka",
"name": "P Nissanka",
"team": "sri-lanka",
"role": "batter",
"total": 57,
"batting": 53,
"bowling": 0,
"fielding": 0,
"playing": 4,
"items": [
{
"part": "playing",
"item": "in the eleven",
"count": 1,
"points": 4
},
{
"part": "batting",
"item": "runs",
"count": 37,
"points": 37
},
"... 4 more"
]
},
"... 9 more"
]
}
]
},
"meta": {
"plan": "plus"
}
}
Errors
| Status | Code | When |
|---|---|---|
| 400 | bad_request | A value is not one this parameter takes, or the key was sent in the address |
| 401 | unauthorized | No key, or one that is unknown or revoked |
| 403 | upgrade_required | The plan does not reach it; the answer names the plan that does |
| 404 | not_found | Nothing at that address |
| 422 | unknown_parameter | A parameter this endpoint does not take |
| 429 | rate_limited | Too fast: wait for Retry-After |
| 429 | quota_exceeded | The day's calls are used: they reset at midnight UTC |