GET Fixtures by Date Range for Team
GET Fixtures by Date Range for Team
GET Fixtures by Date Range for Team1
https://soccer.sportmonks.com/api/v2.0/fixtures/between/{start_date}/{end_date}/{team_ID}
Copied!
Endpoint details
​
Authorization
API Key
Pagination
YES
Allowed nested includes
10
Parameters
Available parameters
​
page
The number of the page you want to browse. Can be used by adding
&page= etc to your request url.include
Enrich the API with more data and/or nested includes. Can be used by adding
&include= etc to your request url.fixtures
Filter on a list of fixture id's separated by comma. Can be used by adding
&fixtures= etc to your request url.bookmakers
Filter on a list of bookmaker id's separated by comma. Can be used by adding
&bookmakers= etc to your request url.markets
Filter on a list of market id's separated by comma. Can be used by adding
&markets= etc to your request url.leagues
Filter on a list of league id's separated by comma. Can be used by adding
&leagues= etc to your request url.status
Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding
&status= etc to your request url.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 firstAssistant secondAssistant fourthOfficial stats shootout league stats probability valuebet news
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:
Example response
Request
Response
Field Description
1
https://soccer.sportmonks.com/api/v2.0/fixtures/between/2021-08-04/2021-09-04/9?api_token={API_TOKEN}
Copied!
1
"data": [
2
{
3
"id": 18125073,
4
"league_id": 23,
5
"season_id": 18344,
6
"stage_id": null,
7
"round_id": null,
8
"group_id": null,
9
"aggregate_id": null,
10
"venue_id": 1315,
11
"referee_id": 15294,
12
"localteam_id": 42,
13
"visitorteam_id": 9,
14
"winner_team_id": null,
15
"weather_report": null,
16
"commentaries": false,
17
"attendance": null,
18
"pitch": null,
19
"details": null,
20
"neutral_venue": false,
21
"winning_odds_calculated": false,
22
"formations": {
23
"localteam_formation": null,
24
"visitorteam_formation": null
25
},
26
"scores": {
27
"localteam_score": 0,
28
"visitorteam_score": 0,
29
"localteam_pen_score": null,
30
"visitorteam_pen_score": null,
31
"ht_score": null,
32
"ft_score": null,
33
"et_score": null,
34
"ps_score": null
35
},
36
"time": {
37
"status": "NS",
38
"starting_at": {
39
"date_time": "2021-08-07 16:15:00",
40
"date": "2021-08-07",
41
"time": "16:15:00",
42
"timestamp": 1628352900,
43
"timezone": "UTC"
44
},
45
"minute": null,
46
"second": null,
47
"added_time": null,
48
"extra_minute": null,
49
"injury_time": null
50
},
51
"coaches": {
52
"localteam_coach_id": 896460,
53
"visitorteam_coach_id": 455361
54
},
55
"standings": {
56
"localteam_position": 1,
57
"visitorteam_position": 2
58
},
59
"assistants": {
60
"first_assistant_id": 12090,
61
"second_assistant_id": 12096,
62
"fourth_official_id": 14814
63
},
64
"leg": "1/1",
65
"colors": null,
66
"deleted": false,
67
"is_placeholder": false
68
},
69
{
70
"id": 18138611,
71
"league_id": 8,
72
"season_id": 18378,
73
"stage_id": 77453700,
74
"round_id": 247583,
75
"group_id": null,
76
"aggregate_id": null,
77
"venue_id": 281313,
78
"referee_id": null,
79
"localteam_id": 6,
80
"visitorteam_id": 9,
81
"winner_team_id": null,
82
"weather_report": null,
83
"commentaries": false,
84
"attendance": null,
85
"pitch": null,
86
"details": null,
87
"neutral_venue": false,
88
"winning_odds_calculated": false,
89
"formations": {
90
"localteam_formation": null,
91
"visitorteam_formation": null
92
},
93
"scores": {
94
"localteam_score": 0,
95
"visitorteam_score": 0,
96
"localteam_pen_score": null,
97
"visitorteam_pen_score": null,
98
"ht_score": null,
99
"ft_score": null,
100
"et_score": null,
101
"ps_score": null
102
},
103
"time": {
104
"status": "NS",
105
"starting_at": {
106
"date_time": "2021-08-15 15:30:00",
107
"date": "2021-08-15",
108
"time": "15:30:00",
109
"timestamp": 1629041400,
110
"timezone": "UTC"
111
},
112
"minute": null,
113
"second": null,
114
"added_time": null,
115
"extra_minute": null,
116
"injury_time": null
117
},
118
"coaches": {
119
"localteam_coach_id": null,
120
"visitorteam_coach_id": null
121
},
122
"standings": {
123
"localteam_position": null,
124
"visitorteam_position": null
125
},
126
"assistants": {
127
"first_assistant_id": null,
128
"second_assistant_id": null,
129
"fourth_official_id": null
130
},
131
"leg": "1/1",
132
"colors": null,
133
"deleted": false,
134
"is_placeholder": false
135
},
Copied!
Field
Description
dataOpens an array of data you've requested
idA unique fixture id
league_idThe unique id of the league the fixture belongs to
season_idThe unique id of the season the fixture belongs to
stage_idThe unique id of the stage the fixture belongs to
round_idThe unique id of the round the fixture belongs to
group_idThe unique id of the group the fixture belongs to
aggregate_idIndicates if the fixture has an aggregated score
venue_idThe unique id of the venue the fixture is played at
referee_idThe unique id of the referee that is in charge of the fixture
localteam_idThe unique id of the local team
visitorteam_idThe unique id of the visitor team
winnerteam_idContains the id of the team that won the fixture
weather_reportOpens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions​
commentariesIndicates if this fixture has commentaries available
attendanceGive information about the visitor attendance of the fixture
pitchdetailsOptional additional information.
neutral_venueIndicates if the fixture was played at a neutral fixture. This often happens in cup finals
Last modified 9mo ago
Export as PDF
Copy link