GET Head 2 Head by Team IDs

Get Head2Head by Team IDs
1
https://soccer.sportmonks.com/api/v2.0/head2head/{team_ID}/{team_ID}
Copied!
Endpoint details
​
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Parameters
Available parameters
​
include
Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url. 
between
​
You can filter between dates: &between= This gives you the opportunity to retrieve all past (or future) matches between two teams.
Include options
localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors. 
You can learn more about what includes are and how they work here:
Includes
Example Response
Request
Response
Field Description
1
https://soccer.sportmonks.com/api/v2.0/head2head/338/53?api_token={API_TOKEN}
Copied!
​
1
 "data": [
2
        {
3
            "id": 16475434,
4
            "league_id": 501,
5
            "season_id": 17141,
6
            "stage_id": 77447501,
7
            "round_id": 194993,
8
            "group_id": null,
9
            "aggregate_id": null,
10
            "venue_id": 8909,
11
            "referee_id": 17250,
12
            "localteam_id": 53,
13
            "visitorteam_id": 338,
14
            "winner_team_id": 53,
15
            "weather_report": {
16
                "code": "clouds",
17
                "type": "broken clouds",
18
                "icon": "https://cdn.sportmonks.com/images/weather/04n.png",
19
                "temperature": {
20
                    "temp": 37.35,
21
                    "unit": "fahrenheit"
22
                },
23
                "temperature_celcius": {
24
                    "temp": 3,
25
                    "unit": "celcius"
26
                },
27
                "clouds": "75%",
28
                "humidity": "93%",
29
                "pressure": 1010,
30
                "wind": {
31
                    "speed": "11.5 m/s",
32
                    "degree": 70
33
                },
34
                "coordinates": {
35
                    "lat": 55.8652,
36
                    "lon": -4.2576
37
                },
38
                "updated_at": "2021-01-27T21:30:20.055902Z"
39
            },
40
            "commentaries": false,
41
            "attendance": null,
42
            "pitch": null,
43
            "details": null,
44
            "neutral_venue": false,
45
            "winning_odds_calculated": true,
46
            "formations": {
47
                "localteam_formation": "4-4-2",
48
                "visitorteam_formation": "3-4-1-2"
49
            },
50
            "scores": {
51
                "localteam_score": 2,
52
                "visitorteam_score": 0,
53
                "localteam_pen_score": null,
54
                "visitorteam_pen_score": null,
55
                "ht_score": "1-0",
56
                "ft_score": "2-0",
57
                "et_score": null,
58
                "ps_score": null
59
            },
60
            "time": {
61
                "status": "FT",
62
                "starting_at": {
63
                    "date_time": "2021-01-27 19:45:00",
64
                    "date": "2021-01-27",
65
                    "time": "19:45:00",
66
                    "timestamp": 1611776700,
67
                    "timezone": "UTC"
68
                },
69
                "minute": 90,
70
                "second": null,
71
                "added_time": null,
72
                "extra_minute": null,
73
                "injury_time": null
74
            },
75
            "coaches": {
76
                "localteam_coach_id": 1467946,
77
                "visitorteam_coach_id": 30082158
78
            },
79
            "standings": {
80
                "localteam_position": 2,
81
                "visitorteam_position": 12
82
            },
83
            "assistants": {
84
                "first_assistant_id": 14860,
85
                "second_assistant_id": 18758,
86
                "fourth_official_id": 15815
87
            },
88
            "leg": "1/1",
89
            "colors": {
90
                "localteam": {
91
                    "color": "#F0F0F0",
92
                    "kit_colors": "#F0F0F0,#139343,#5B0623,#0A0A0A,#5C8FAE,#FFDF1B,#F0F0F0"
93
                },
94
                "visitorteam": {
95
                    "color": "#C40010",
96
                    "kit_colors": "#F0F0F0,#C40010,#5B0623,#0A0A0A,#5C8FAE,#FFDF1B,#F0F0F0"
97
                }
98
            },
99
            "deleted": false,
100
            "is_placeholder": false
101
        },
Copied!
Field
Description
data
Opens an array of data you've requested
id
A unique fixture id
league_id
The unique id of the league the fixture belongs to
season_id
The unique id of the season the fixture belongs to
stage_id
The unique id of the stage the fixture belongs to
round_id
The unique id of the round the fixture belongs to
group_id
The unique id of the group the fixture belongs to
aggregate_id
Indicates if the fixture has an aggregated score
venue_id
The unique id of the venue the fixture is played at
referee_id
The unique id of the referee that is in charge of the fixture
localteam_id
The unique id of the local team
visitorteam_id
The unique id of the visitor team
winnerteam_id
Contains the id of the team that won the fixture
weather_report
Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions​
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
Gives information about the pitch. Possible values can be found in our statuses and definitions​
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
Check this endpoint in Postman.
                                                              ​
​​

Endpoint overview - Previous

Head 2 Head

Next - Endpoint overview

Standings

Last modified 9mo ago

Export as PDF

Copy link

Contents

Get Head2Head by Team IDs