GETTeam vs team
Previous meetings of two teams with the result and form of each one.
/v2.2/h2h/ with t=teams
Try it in the interactive referenceAll Head to head operations
Request
GET /v2.2/h2h/?user=USER&token=TOKEN&t=teams&team1=99&team2=113- Every request needs the
userandtokenquery parameters of the account.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
team1 | yes | First team ID. | 99 |
team2 | yes | Second team ID. | 113 |
Example response
{
"data": {
"home": {
"id": 99,
"name": "FC Barcelona",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/99.png",
"events": {
"overall": [
{
"id": 2632670,
"startdate": "2026-08-31 19:30:00",
"league": {
"id": 637,
"name": "LaLiga",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/637.png",
"country": {
"id": 5,
"name": "Spain",
"cc": "es"
}
},
"teams": {
"home": {
"id": 99,
"name": "FC Barcelona",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/99.png"
},
"away": {
"id": 2403,
"name": "Rayo Vallecano",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/2403.png"
}
},
"scores": {
"home_score": "5",
"away_score": "2",
"ht_score": "2-1",
"ft_score": "5-2",
"et_score": null,
"ps_score": ""
},
"ft_score": "5-2",
"form": "W"
}
],
"home": [
{
"id": 2632670,
"startdate": "2026-08-31 19:30:00",
"league": {
"id": 637,
"name": "LaLiga",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/637.png",
"country": {
"id": 5,
"name": "Spain",
"cc": "es"
}
},
"teams": {
"home": {
"id": 99,
"name": "FC Barcelona",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/99.png"
},
"away": {
"id": 2403,
"name": "Rayo Vallecano",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/2403.png"
}
},
"scores": {
"home_score": "5",
"away_score": "2",
"ht_score": "2-1",
"ft_score": "5-2",
"et_score": null,
"ps_score": ""
},
"ft_score": "5-2",
"form": "W"
}
],
"away": [
{
"id": 2632655,
"startdate": "2026-08-23 19:30:00",
"league": {
"id": 637,
"name": "LaLiga",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/637.png",
"country": {
"id": 5,
"name": "Spain",
"cc": "es"
}
},
"teams": {
"home": {
"id": 2411,
"name": "Elche CF",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/2411.png"
},
"away": {
"id": 99,
"name": "FC Barcelona",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/99.png"
}
},
"scores": {
"home_score": "0",
"away_score": "5",
"ht_score": "0-2",
"ft_score": "0-5",
"et_score": null,
"ps_score": ""
},
"ft_score": "0-5",
"form": "W"
}
]
}
},
"away": {
"id": 113,
"name": "Real Madrid",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/113.png",
"events": {
"overall": [
{
"id": 2632666,
"startdate": "2026-08-30 15:00:00",
"league": {
"id": 637,
"name": "LaLiga",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/637.png",
"country": {
"id": 5,
"name": "Spain",
"cc": "es"
}
},
"teams": {
"home": {
"id": 113,
"name": "Real Madrid",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/113.png"
},
"away": {
"id": 2409,
"name": "Malaga CF",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/2409.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"
}
],
"home": [
{
"id": 2632666,
"startdate": "2026-08-30 15:00:00",
"league": {
"id": 637,
"name": "LaLiga",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/637.png",
"country": {
"id": 5,
"name": "Spain",
"cc": "es"
}
},
"teams": {
"home": {
"id": 113,
"name": "Real Madrid",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/113.png"
},
"away": {
"id": 2409,
"name": "Malaga CF",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/2409.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": 2632652,
"startdate": "2026-08-22 19:30:00",
"league": {
"id": 637,
"name": "LaLiga",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/637.png",
"country": {
"id": 5,
"name": "Spain",
"cc": "es"
}
},
"teams": {
"home": {
"id": 127,
"name": "RCD Espanyol Barcelona",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/127.png"
},
"away": {
"id": 113,
"name": "Real Madrid",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/113.png"
}
},
"scores": {
"home_score": "1",
"away_score": "2",
"ht_score": "1-1",
"ft_score": "1-2",
"et_score": null,
"ps_score": ""
},
"ft_score": "1-2",
"form": "W"
}
]
}
},
"h2h": [
{
"id": 2429729,
"startdate": "2026-05-10 19:00:00",
"league": {
"id": 637,
"name": "LaLiga",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/637.png",
"country": {
"id": 5,
"name": "Spain",
"cc": "es"
}
},
"teams": {
"home": {
"id": 99,
"name": "FC Barcelona",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/99.png"
},
"away": {
"id": 113,
"name": "Real Madrid",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/113.png"
}
},
"scores": {
"home_score": "2",
"away_score": "0",
"ht_score": "2-0",
"ft_score": "2-0",
"et_score": "",
"ps_score": ""
},
"ft_score": "2-0",
"form": "W"
}
]
},
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 1,
"count": 1,
"total": 1,
"msg": ""
}
}