Documentation / Subjects
Head to head, sports data API
Head to headEvery meeting between two sides, with the record between them.
Team sports take team and opponent; one-against-one sports take player and opponent. Both are ids from our answers. Leave one out and the answer names it before any data is read.
Try it
Darts: Head to head, with your key.
200 OK1270 ms1 recordReal answer from 2026-11-03, trimmed
{
"data": {
"players": [
{
"player_id": "dt_6eefhw35y8",
"name": "Ronan McDonagh",
"wins": 0,
"legs": 0
},
{
"player_id": "dt_pwtkqmm3fc",
"name": "Patrick Dekker",
"wins": 0,
"legs": 0
}
],
"meetings": 0,
"first_meeting": null,
"last_meeting": null,
"matches": []
},
"meta": {
"sport": "darts",
"endpoint": "/head-to-head",
"count": 0,
"as_of": "2026-11-03T00:19:41Z",
"cached": false,
"age_seconds": 0
}
}No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.
The endpoints
Every sport that answers it.
GET /v1/football/head-to-headFootball: Every meeting between two teamsOpen page ›GET /v1/basketball/head-to-headBasketball: Every meeting between two teamsOpen page ›GET /v1/rugby/head-to-headRugby: Every meeting between two teamsOpen page ›GET /v1/darts/head-to-headDarts: Every meeting between two playersOpen page ›GET /v1/volleyball/head-to-headVolleyball: Every meeting between two teamsOpen page ›GET /v1/table-tennis/head-to-headTable tennis: Every meeting between two playersOpen page ›GET /v1/badminton/head-to-headBadminton: Every meeting between two playersOpen page ›GET /v1/football/teams/{id}Football: A team and its recordOpen page ›GET /v1/basketball/teams/{id}Basketball: A team and its recordOpen page ›GET /v1/rugby/teams/{id}Rugby: A team and its recordOpen page ›GET /v1/volleyball/teams/{id}Volleyball: A team and its recordOpen page ›GET /v1/football/players/{id}Football: A player and their figuresOpen page ›GET /v1/cricket/players/{id}Cricket: A player's career by formatOpen page ›GET /v1/basketball/players/{id}Basketball: A player and their figuresOpen page ›GET /v1/rugby/players/{id}Rugby: A player and their figuresOpen page ›GET /v1/darts/players/{id}Darts: A player and their recordOpen page ›GET /v1/volleyball/players/{id}Volleyball: A player and their figuresOpen page ›GET /v1/table-tennis/players/{id}Table tennis: A player and their recordOpen page ›GET /v1/badminton/players/{id}Badminton: A player and their recordOpen page ›