Match
GET
/v1/matches/{match}On each planFree keyLast 30 daysMatch WeekLast 30 daysArchiveTo yesterdayProIn fullAnalyst ProIn fullMCP toolget_match
One match: teams, result, toss, venue, officials, player of the match and the innings totals. An international held without its balls answers coverage scorecard or totals, with each innings, its extras and fall of wickets, or result_only. Older than 30 days on the free key comes back as a summary.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
match | path | match address | yes |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"match": "2026-09-17-sri-lanka-v-england",
"date": "2026-09-17",
"end_date": "2026-09-17",
"format": "t20i",
"gender": "male",
"teams": [
{
"team": "sri-lanka",
"name": "Sri Lanka"
},
{
"team": "england",
"name": "England"
}
],
"result": "England won by 6 wickets",
"coverage": "full",
"competition": {
"competition": "sri-lanka-tour-of-england",
"name": "Sri Lanka tour of England"
},
"season": "2026",
"stage": "Match 2",
"official_number": 4129,
"venue": {
"venue": "sophia-gardens",
"name": "Sophia Gardens",
"city": "Cardiff"
},
"toss": "England, chose to field",
"rain_rule": null,
"innings": [
{
"team": "sri-lanka",
"runs": 145,
"wickets": 9,
"overs": "20",
"innings_declared": false,
"is_super_over": false,
"chase_target": null
},
{
"team": "england",
"runs": 146,
"wickets": 4,
"overs": "12.1",
"innings_declared": false,
"is_super_over": false,
"chase_target": 146
}
],
"player_of_the_match": [
{
"player": "la-dawson",
"name": "LA Dawson"
}
],
"officials": {
"on_field_umpires": [
"RJ Warren",
"Rob White"
],
"third_umpire": [
"GD Lloyd"
],
"fourth_umpire": [
"James Middlebrook"
],
"referee": [
"JJ Crowe"
]
}
},
"meta": {
"plan": "plus",
"detail": "full"
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.