Team matches
GET
/v1/teams/{team}/matchesOn each planFree keyLast 30 daysMatch WeekLast 30 daysArchiveTo yesterdayProIn fullAnalyst ProIn full
A team's matches, with every filter of /v1/matches.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
team | path | team address | yes |
date | query | One day, YYYY-MM-DD | |
from | query | On or after | |
to | query | On or before | |
year | query | A calendar year | |
month | query | With year, 1 to 12 | |
format | query | test, odi, t20i, t20, multi-day, one-day | |
gender | query | male or female | |
page | query | Page number, from 1 | |
limit | query | Results per page, 1 to 100 (default 50) |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/teams/england/matches"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/teams/england/matches",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/teams/england/matches",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/teams/england/matches"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/teams/england/matches",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/teams/england/matches",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": [
{
"match": "2026-09-27-england-v-sri-lanka",
"date": "2026-09-27",
"format": "odi",
"gender": "male",
"coverage": "full",
"competition": "Sri Lanka tour of England",
"stage": "Match 3",
"ground": null,
"official_number": null,
"teams": [
{
"team": "england",
"name": "England",
"score": "355/7",
"overs": "50",
"won": true
},
{
"team": "sri-lanka",
"name": "Sri Lanka",
"score": "132",
"overs": "29.1",
"won": false
}
],
"result": "England won by 223 runs"
},
{
"match": "2026-09-24-sri-lanka-v-england",
"date": "2026-09-24",
"format": "odi",
"gender": "male",
"coverage": "full",
"competition": "Sri Lanka tour of England",
"stage": "Match 2",
"ground": null,
"official_number": null,
"teams": [
{
"team": "sri-lanka",
"name": "Sri Lanka",
"score": "321/6",
"overs": "50",
"won": true
},
{
"team": "england",
"name": "England",
"score": "305/9",
"overs": "50",
"won": false
}
],
"result": "Sri Lanka won by 16 runs"
},
"... 48 more"
],
"meta": {
"plan": "plus",
"count": 50,
"next_cursor": "Y2RiOnAy",
"page": 1,
"per_page": 50,
"total": 2926,
"total_pages": 59,
"next_page": 2,
"prev_page": null
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.