Upsets
On each planFree keyNot includedMatch WeekNot includedArchiveNot includedProNot includedAnalyst ProIn fullMCP toolfind_upsets
Every result our ratings did not expect, from every men's and women's international and domestic match held back to 1877 (club and school matches are not in it), each with the reasons in plain words.
GET
https://api.cricketdatabase.com/v1/upsetsTry it
Kept in this browser and filled in on every docs page.
Parameters
| Name | Type | Required | Description | Values |
|---|---|---|---|---|
date | date | no | YYYY-MM-DD | YYYY-MM-DD |
from | date | no | YYYY-MM-DD | YYYY-MM-DD |
to | date | no | YYYY-MM-DD | YYYY-MM-DD |
year | integer | no | Four digits, such as 2011 | |
format | string | no | test, odi, t20i, t20, multi-day or one-day | testodit20it20multi-dayone-day |
gender | string | no | male or female | malefemale |
team | string | no | ||
competition | string | no | ||
min_size | integer | no | 0 to 100 | |
chance_from | string | no | rating or in_play | ratingin_play |
outcome | string | no | won or drew | wondrew |
sort | string | no | newest or biggest (default newest) | newestbiggest |
page | integer | no | From 1 | |
limit | integer | no | 1 to 100 (default 50) |
Returns
| Field | Type | What it holds |
|---|---|---|
data[] | array | match, date, format, gender, competition, ground, coverage, teams, result, underdog, opponent, outcome, chance_before, chance_lowest, lowest_at, chance_from, upset_size, rating_gap, reasons |
data[].teams[].team | string | A side's address name |
data[].teams[].name | string | The name as shown |
data[].teams[].score | string | Runs and wickets, every innings |
data[].teams[].overs | string | Overs faced |
data[].teams[].won | boolean | Whether this side won |
data[].underdog.team | string | A side's address name |
data[].underdog.name | string | The name as shown |
data[].opponent.team | string | A side's address name |
data[].opponent.name | string | The name as shown |
meta | object | |
meta.plan | string | The plan the key is on |
meta.count | integer | Items in this page |
meta.next_cursor | string | Where the next page starts, null at the end |
meta.page | integer | This page's number |
meta.per_page | integer | Items a page |
meta.total | integer | Items in all, with these filters |
meta.total_pages | integer | Pages in all |
meta.next_page | integer | The next page, null at the end |
meta.prev_page | string or null | The page before, null at the start |
meta.sort | string |
Example answer
A real answer for /v1/upsets?format=odi&sort=biggest, lists cut to their first two items.
{
"data": [
{
"match": "2005-06-18-australia-v-bangladesh",
"date": "2005-06-18",
"format": "odi",
"gender": "male",
"competition": "NatWest Challenge",
"ground": "Sophia Gardens",
"coverage": "full",
"teams": [
{
"team": "australia",
"name": "Australia",
"score": "249/5",
"overs": "50",
"won": false
},
{
"team": "bangladesh",
"name": "Bangladesh",
"score": "250/5",
"overs": "49.2",
"won": true
}
],
"result": "Bangladesh won by 5 wickets",
"underdog": {
"team": "bangladesh",
"name": "Bangladesh"
},
"opponent": {
"team": "australia",
"name": "Australia"
},
"outcome": "won",
"chance_before": 2,
"chance_lowest": 30.3,
"lowest_at": "25 ov, second innings",
"chance_from": "rating",
"upset_size": 96,
"rating_gap": -939,
"reasons": [
"Bangladesh were given 2% by our ratings before the match",
"Rated 939 points below Australia",
"... 3 more"
]
},
{
"match": "2009-11-04-west-indies-v-england-women",
"date": "2009-11-04",
"format": "odi",
"gender": "female",
"competition": null,
"ground": "Basseterre",
"coverage": "scorecard",
"teams": [
{
"team": "west-indies",
"name": "West Indies",
"score": null,
"overs": null,
"won": true
},
{
"team": "england",
"name": "England",
"score": null,
"overs": null,
"won": false
}
],
"result": "West Indies won by 40 runs",
"underdog": {
"team": "west-indies",
"name": "West Indies"
},
"opponent": {
"team": "england",
"name": "England"
},
"outcome": "won",
"chance_before": 2.6,
"chance_lowest": null,
"lowest_at": null,
"chance_from": "rating",
"upset_size": 95,
"rating_gap": -632,
"reasons": [
"West Indies were given 2.6% by our ratings before the match",
"Rated 632 points below England",
"... 3 more"
]
},
"... 48 more"
],
"meta": {
"plan": "plus",
"count": 50,
"next_cursor": "Y2RiOnAy",
"page": 1,
"per_page": 50,
"total": 908,
"total_pages": 19,
"next_page": 2,
"prev_page": null,
"sort": "biggest"
}
}
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 |
| 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 |