Head to head
GET
/v1/teams/{team}/head-to-head/{other}On each planFree keyNot includedMatch WeekNot includedArchiveIn fullProIn fullAnalyst ProIn fullMCP toolhead_to_head
Two teams against each other, by format, with the last ten meetings.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
team | path | team address | yes |
other | path | other address | yes |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/teams/england/head-to-head/australia"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/teams/england/head-to-head/australia",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/teams/england/head-to-head/australia",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/teams/england/head-to-head/australia"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/teams/england/head-to-head/australia",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/teams/england/head-to-head/australia",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"teams": [
"england",
"australia"
],
"by_format": {
"odi": {
"played": 119,
"england": 43,
"australia": 73,
"other": 3
},
"t20i": {
"played": 65,
"england": 28,
"australia": 32,
"other": 5
},
"test": {
"played": 73,
"england": 21,
"australia": 36,
"other": 16
}
},
"recent": [
{
"match": "2026-07-05-england-v-australia-women",
"date": "2026-07-05",
"format": "t20i",
"gender": "female",
"coverage": "full",
"competition": "ICC Women's T20 World Cup",
"stage": "Final",
"ground": null,
"official_number": null,
"teams": [
{
"team": "england",
"name": "England",
"score": "150/4",
"overs": "20",
"won": false
},
{
"team": "australia",
"name": "Australia",
"score": "153/3",
"overs": "17.1",
"won": true
}
],
"result": "Australia won by 7 wickets"
},
{
"match": "2026-01-04-england-v-australia",
"date": "2026-01-04",
"format": "test",
"gender": "male",
"coverage": "full",
"competition": "The Ashes",
"stage": "Match 5",
"ground": null,
"official_number": null,
"teams": [
{
"team": "england",
"name": "England",
"score": "384 & 342",
"overs": "88.2",
"won": false
},
{
"team": "australia",
"name": "Australia",
"score": "567 & 161/5",
"overs": "31.2",
"won": true
}
],
"result": "Australia won by 5 wickets"
},
"... 8 more"
]
},
"meta": {
"plan": "plus"
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.