GETMatch head to head
Previous meetings of the two teams of a match.
/v2.2/h2h/ with t=match
Try it in the interactive referenceAll Head to head operations
Request
GET /v2.2/h2h/?user=USER&token=TOKEN&t=match&id=2589310- Every request needs the
userandtokenquery parameters of the account.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
id | yes | Match ID. | 2589310 |
Example response
{
"data": {
"home": {
"id": 20,
"name": "Chelsea FC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/20.png",
"events": {
"overall": [
{
"id": 2589310,
"startdate": "2026-08-30 13:00:00",
"league": {
"id": 583,
"name": "Premier League",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/583.png",
"country": {
"id": 3,
"name": "England",
"cc": "en"
}
},
"teams": {
"home": {
"id": 20,
"name": "Chelsea FC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/20.png"
},
"away": {
"id": 12,
"name": "Brighton & Hove Albion",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/12.png"
}
},
"scores": {
"home_score": "4",
"away_score": "3",
"ht_score": "3-1",
"ft_score": "4-3",
"et_score": null,
"ps_score": ""
},
"ft_score": "4-3",
"form": "W"
}
],
"home": [
{
"id": 2589310,
"startdate": "2026-08-30 13:00:00",
"league": {
"id": 583,
"name": "Premier League",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/583.png",
"country": {
"id": 3,
"name": "England",
"cc": "en"
}
},
"teams": {
"home": {
"id": 20,
"name": "Chelsea FC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/20.png"
},
"away": {
"id": 12,
"name": "Brighton & Hove Albion",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/12.png"
}
},
"scores": {
"home_score": "4",
"away_score": "3",
"ht_score": "3-1",
"ft_score": "4-3",
"et_score": null,
"ps_score": ""
},
"ft_score": "4-3",
"form": "W"
}
],
"away": [
{
"id": 2589307,
"startdate": "2026-08-24 19:00:00",
"league": {
"id": 583,
"name": "Premier League",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/583.png",
"country": {
"id": 3,
"name": "England",
"cc": "en"
}
},
"teams": {
"home": {
"id": 262,
"name": "Fulham FC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/262.png"
},
"away": {
"id": 20,
"name": "Chelsea FC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/20.png"
}
},
"scores": {
"home_score": "2",
"away_score": "3",
"ht_score": "1-2",
"ft_score": "2-3",
"et_score": null,
"ps_score": ""
},
"ft_score": "2-3",
"form": "W"
}
]
}
},
"away": {
"id": 12,
"name": "Brighton & Hove Albion",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/12.png",
"events": {
"overall": [
{
"id": 2589310,
"startdate": "2026-08-30 13:00:00",
"league": {
"id": 583,
"name": "Premier League",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/583.png",
"country": {
"id": 3,
"name": "England",
"cc": "en"
}
},
"teams": {
"home": {
"id": 20,
"name": "Chelsea FC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/20.png"
},
"away": {
"id": 12,
"name": "Brighton & Hove Albion",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/12.png"
}
},
"scores": {
"home_score": "4",
"away_score": "3",
"ht_score": "3-1",
"ft_score": "4-3",
"et_score": null,
"ps_score": ""
},
"ft_score": "4-3",
"form": "L"
}
],
"home": [
{
"id": 2649268,
"startdate": "2026-08-27 18:30:00",
"league": {
"id": 4569,
"name": "UEFA Europa Conference League",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/4569.png",
"country": {
"id": 135,
"name": "Europe",
"cc": ""
}
},
"teams": {
"home": {
"id": 12,
"name": "Brighton & Hove Albion",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/12.png"
},
"away": {
"id": 373,
"name": "Tromsoe IL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/373.png"
}
},
"scores": {
"home_score": "4",
"away_score": "0",
"ht_score": "3-0",
"ft_score": "4-0",
"et_score": null,
"ps_score": ""
},
"ft_score": "4-0",
"form": "W"
}
],
"away": [
{
"id": 2589310,
"startdate": "2026-08-30 13:00:00",
"league": {
"id": 583,
"name": "Premier League",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/583.png",
"country": {
"id": 3,
"name": "England",
"cc": "en"
}
},
"teams": {
"home": {
"id": 20,
"name": "Chelsea FC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/20.png"
},
"away": {
"id": 12,
"name": "Brighton & Hove Albion",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/12.png"
}
},
"scores": {
"home_score": "4",
"away_score": "3",
"ht_score": "3-1",
"ft_score": "4-3",
"et_score": null,
"ps_score": ""
},
"ft_score": "4-3",
"form": "L"
}
]
}
},
"h2h": [
{
"id": 2589310,
"startdate": "2026-08-30 13:00:00",
"league": {
"id": 583,
"name": "Premier League",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/583.png",
"country": {
"id": 3,
"name": "England",
"cc": "en"
}
},
"teams": {
"home": {
"id": 20,
"name": "Chelsea FC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/20.png"
},
"away": {
"id": 12,
"name": "Brighton & Hove Albion",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/12.png"
}
},
"scores": {
"home_score": "4",
"away_score": "3",
"ht_score": "3-1",
"ft_score": "4-3",
"et_score": null,
"ps_score": ""
},
"ft_score": "4-3",
"form": "W"
}
]
},
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 1,
"count": 1,
"total": 1,
"msg": ""
}
}