Previous meetings between any two clubs with scores and a ready-made summary — wins, draws, goals per match, both-teams-scored and over 2.5 counts.
Head-to-head stats are a staple of every match preview, but collecting them means matching team names across seasons and competitions — and recounting the summary every time.
Ask for two team IDs and get the meetings plus a summary you can print as is. History covers domestic leagues since 2019 (Argentina, Brazil and MLS since 2012) and UEFA club competitions.
| Parameter | Description |
|---|---|
last | Number of meetings, 1–20 (default 6) |
venue | all, or only matches at the first team’s home |
competition | Filter by league or cup |
{
"teams": ["Liverpool", "Manchester City"],
"meetings": 6,
"summary": {
"liverpool_wins": 2, "draws": 2, "manchester_city_wins": 2,
"goals_per_match": 2.33, "btts": 3, "over_2_5": 2
},
"matches": [
{ "date": "2026-02-08", "competition": "Premier League",
"home": "Liverpool", "away": "Manchester City", "score": "1-2" }
// …
],
"source": "football-data.co.uk"
}
| Field | Type | Description |
|---|---|---|
meetings | int | Number of matches in the response |
summary | object | Wins for each team, draws, goals per match, BTTS and over 2.5 counts |
matches[] | array | Date, competition, home, away and score of each meeting |
source | string | Data attribution for the underlying results |
Add a “last 6 meetings” block to every match page automatically.
Generate H2H facts for dozens of fixtures a day without manual research.
Use historical goal and BTTS rates between specific opponents as features.
Yes — meetings in UEFA club competitions are included alongside domestic league games.
Since 2019 for European leagues and since 2012 for Argentina, Brazil and MLS.
Use the same normalised team IDs as in the form and standings endpoints, e.g. manchester-city.
Free plan for small projects. Early-access users get 50% off for the first year.