Fantasy player form
On each planFree keyLast 30 daysMatch WeekLast 30 daysArchiveLast 30 daysProLast 30 daysAnalyst ProIn fullMCP toolfantasy_player_form
A player's fantasy record in each format family they have played since 2001: their rating (the points expected next against an average side), the overall and role rank among active players, the last 10 matches' average, the last year's, the floor and ceiling (the 20th and 80th percentiles of the last 20 matches), the average strength of the sides faced, and their last 10 matches with the team, the opponent and its rating, and the points by part.
GET
https://api.cricketdatabase.com/v1/fantasy/players/{player}/formTry it
Kept in this browser and filled in on every docs page.
Parameters
| Name | Type | Required | Description | Values |
|---|---|---|---|---|
player | string | yes | In the address: the player's address name | je-root |
Returns
| Field | Type | What it holds |
|---|---|---|
data | object | |
data.player | string | A player's address name |
data.name | string | The name as shown |
data.families[] | array | family, family_is, gender, role, active, rank, role_rank, rating, form10, last_365_days, floor, ceiling, opposition, matches, average, first_match, last_match, recent |
data.families[].last_365_days.matches | integer | |
data.families[].last_365_days.average | number | |
data.families[].recent[].match | string | The match's address name, for /v1/matches/{match} |
data.families[].recent[].date | string | The first day of the match |
data.families[].recent[].team | string | A side's address name |
data.families[].recent[].opponent | string or null | |
data.families[].recent[].opposition_rating | string or null | |
data.families[].recent[].role | string | |
data.families[].recent[].total | number | Items in all, with these filters |
data.families[].recent[].batting | number | |
data.families[].recent[].bowling | number | |
data.families[].recent[].fielding | number | |
data.families[].recent[].playing | number | |
meta | object | |
meta.plan | string | The plan the key is on |
meta.note | string |
Example answer
A real answer for /v1/fantasy/players/je-root/form, lists cut to their first two items.
{
"data": {
"player": "je-root",
"name": "JE Root",
"families": [
{
"family": "oneday",
"family_is": "ODIs and one-day (List A) matches",
"gender": "male",
"role": "batter",
"active": true,
"rank": 188,
"role_rank": 33,
"rating": 58.6,
"form10": 64.5,
"last_365_days": {
"matches": 14,
"average": 73.6
},
"floor": 27.4,
"ceiling": 104.8,
"opposition": 1811,
"matches": 205,
"average": 60.6,
"first_match": "2013-01-11",
"last_match": "2026-10-29",
"recent": [
{
"match": "2026-10-29-england-v-sri-lanka",
"date": "2026-10-29",
"team": "england",
"opponent": null,
"opposition_rating": null,
"role": "batter",
"total": 29,
"batting": 0,
"bowling": 25,
"fielding": 0,
"playing": 4
},
{
"match": "2026-10-25-england-v-pakistan",
"date": "2026-10-25",
"team": "england",
"opponent": "pakistan",
"opposition_rating": 1818,
"role": "batter",
"total": 18,
"batting": 6,
"bowling": 0,
"fielding": 8,
"playing": 4
},
"... 8 more"
]
},
{
"family": "long",
"family_is": "Tests and multi-day matches",
"gender": "male",
"role": "batter",
"active": true,
"rank": 104,
"role_rank": 10,
"rating": 103.6,
"form10": 118.8,
"last_365_days": {
"matches": 14,
"average": 108.4
},
"floor": 48.6,
"ceiling": 191.2,
"opposition": 1633,
"matches": 198,
"average": 123.7,
"first_match": "2012-12-13",
"last_match": "2026-09-09",
"recent": [
{
"match": "2026-09-09-pakistan-v-england",
"date": "2026-09-09",
"team": "england",
"opponent": "pakistan",
"opposition_rating": 1362,
"role": "batter",
"total": 98,
"batting": 86,
"bowling": 0,
"fielding": 8,
"playing": 4
},
{
"match": "2026-08-27-england-v-pakistan",
"date": "2026-08-27",
"team": "england",
"opponent": "pakistan",
"opposition_rating": 1373,
"role": "batter",
"total": 35,
"batting": 31,
"bowling": 0,
"fielding": 0,
"playing": 4
},
"... 8 more"
]
},
"... 1 more"
]
},
"meta": {
"plan": "plus",
"note": "rating: the points expected next against an average side; floor and ceiling: the 20th and 80th percentiles of the last 20 matches; rank: among active players (10 matches or more, the newest within a year) of the family and gender; recent: the last 10 matches, by our default rules (/v1/fantasy/matches/{match}/points scores any of them by yours)"
}
}
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 |