GET Fixtures by Date

GET Fixtures by Date
1
https://soccer.sportmonks.com/api/v2.0/fixtures/date/{date}
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:
Includes
Example response
Request
Response
Field Description
1
https://soccer.sportmonks.com/api/v2.0/fixtures/date/2021-08-04?api_token={API_TOKEN}
Copied!
1
"data": [
2
        {
3
            "id": 17893546,
4
            "league_id": 699,
5
            "season_id": 18166,
6
            "stage_id": 77452627,
7
            "round_id": 239455,
8
            "group_id": null,
9
            "aggregate_id": null,
10
            "venue_id": 5345,
11
            "referee_id": null,
12
            "localteam_id": 15341,
13
            "visitorteam_id": 254167,
14
            "winner_team_id": 15341,
15
            "weather_report": {
16
                "code": "clouds",
17
                "type": "broken clouds",
18
                "icon": "https://cdn.sportmonks.com/images/weather/04n.png",
19
                "temperature": {
20
                    "temp": 50.95,
21
                    "unit": "fahrenheit"
22
                },
23
                "temperature_celcius": {
24
                    "temp": 10.5,
25
                    "unit": "celcius"
26
                },
27
                "clouds": "57%",
28
                "humidity": "68%",
29
                "pressure": 1020,
30
                "wind": {
31
                    "speed": "4.72 m/s",
32
                    "degree": 117
33
                },
34
                "coordinates": {
35
                    "lat": -0.2299,
36
                    "lon": -78.5249
37
                },
38
                "updated_at": "2021-08-04T01:45:02.268709Z"
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": null,
48
                "visitorteam_formation": null
49
            },
50
            "scores": {
51
                "localteam_score": 2,
52
                "visitorteam_score": 0,
53
                "localteam_pen_score": null,
54
                "visitorteam_pen_score": null,
55
                "ht_score": "0-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-08-04 00:00:00",
64
                    "date": "2021-08-04",
65
                    "time": "00:00:00",
66
                    "timestamp": 1628035200,
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": 37437835,
77
                "visitorteam_coach_id": null
78
            },
79
            "standings": {
80
                "localteam_position": 7,
81
                "visitorteam_position": 4
82
            },
83
            "assistants": {
84
                "first_assistant_id": null,
85
                "second_assistant_id": null,
86
                "fourth_official_id": null
87
            },
88
            "leg": "1/1",
89
            "colors": {
90
                "localteam": {
91
                    "color": "#F0F0F0",
92
                    "kit_colors": "#F0F0F0,#F0F0F0,#007848,#F0F0F0,#FF0000,#0000FF,#F0F0F0"
93
                },
94
                "visitorteam": {
95
                    "color": "#0046A8",
96
                    "kit_colors": "#F0F0F0,#0046A8,#0046A8,#0046A8,#C40010,#0046A8,#0A0A0A"
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.
                                                                 ​
​​

GET Last Updated Fixtures

GET Fixtures by Date Range

Last modified 9mo ago

Export as PDF

Copy link

Contents

GET Fixtures by Date