Venue matches
GET
/v1/venues/{venue}/matchesOn each planFree keyLast 30 daysMatch WeekLast 30 daysArchiveTo yesterdayProIn fullAnalyst ProIn full
Matches at a ground, with every filter of /v1/matches.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
venue | path | venue 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/venues/sophia-gardens/matches"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/venues/sophia-gardens/matches",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/venues/sophia-gardens/matches",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/venues/sophia-gardens/matches"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/venues/sophia-gardens/matches",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/venues/sophia-gardens/matches",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": [
{
"match": "2026-09-24-glamorgan-v-essex",
"date": "2026-09-24",
"format": "multi-day",
"gender": "male",
"coverage": "full",
"competition": "County Championship",
"stage": "Match 69",
"ground": null,
"official_number": null,
"teams": [
{
"team": "glamorgan",
"name": "Glamorgan",
"score": "505",
"overs": "157.1",
"won": false
},
{
"team": "essex",
"name": "Essex",
"score": "129 & 351/6",
"overs": "85.3",
"won": false
}
],
"result": "Match drawn"
},
{
"match": "2026-09-17-sri-lanka-v-england",
"date": "2026-09-17",
"format": "t20i",
"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": "145/9",
"overs": "20",
"won": false
},
{
"team": "england",
"name": "England",
"score": "146/4",
"overs": "12.1",
"won": true
}
],
"result": "England won by 6 wickets"
},
"... 48 more"
],
"meta": {
"plan": "plus",
"count": 50,
"next_cursor": "Y2RiOnAy",
"page": 1,
"per_page": 50,
"total": 210,
"total_pages": 5,
"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.