GET Last Updated Fixtures
To help you keep your data in sync we have implemented an endpoint that returns you all the games that have received updates within 2 hours ago. this will also imply games that have an updated lineup,
GET Last Updated Fixtures
GET Last Updated Fixtures1
https://soccer.sportmonks.com/api/v2.0/fixtures/updates
Copied!
Endpoint details
​
Authorization
API Key
Pagination
YES
Allowed nested includes
3
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 stats 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/updates?api_token={API_TOKEN}
Copied!
1
"data": [
2
{
3
"id": 16475287,
4
"league_id": 501,
5
"season_id": 17141,
6
"stage_id": 77447501,
7
"round_id": 194968,
8
"group_id": null,
9
"aggregate_id": null,
10
"venue_id": 8909,
11
"referee_id": 14859,
12
"localteam_id": 53,
13
"visitorteam_id": 338,
14
"winner_team_id": 53,
15
"weather_report": {
16
"code": "clouds",
17
"type": "few clouds",
18
"icon": "https://cdn.sportmonks.com/images/weather/02d.png",
19
"temperature": {
20
"temp": 59.94,
21
"unit": "fahrenheit"
22
},
23
"temperature_celcius": {
24
"temp": 15.5,
25
"unit": "celcius"
26
},
27
"clouds": "20%",
28
"humidity": "67%",
29
"pressure": 1014,
30
"wind": {
31
"speed": "10.29 m/s",
32
"degree": 300
33
},
34
"coordinates": {
35
"lat": 55.87,
36
"lon": -4.26
37
},
38
"updated_at": "2020-08-02T17:15:04.814798Z"
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-2-3-1",
48
"visitorteam_formation": "4-4-2"
49
},
50
"scores": {
51
"localteam_score": 5,
52
"visitorteam_score": 1,
53
"localteam_pen_score": null,
54
"visitorteam_pen_score": null,
55
"ht_score": "2-1",
56
"ft_score": "5-1",
57
"et_score": null,
58
"ps_score": null
59
},
60
"time": {
61
"status": "FT",
62
"starting_at": {
63
"date_time": "2020-08-02 15:30:00",
64
"date": "2020-08-02",
65
"time": "15:30:00",
66
"timestamp": 1596382200,
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": 1,
81
"visitorteam_position": 12
82
},
83
"assistants": {
84
"first_assistant_id": 12118,
85
"second_assistant_id": 17249,
86
"fourth_official_id": 15815
87
},
88
"leg": "1/1",
89
"colors": {
90
"localteam": {
91
"color": "#007848",
92
"kit_colors": "#F0F0F0,#139343,#5B0623,#0A0A0A,#5C8FAE,#FFDF1B,#F0F0F0"
93
},
94
"visitorteam": {
95
"color": "#0046A8",
96
"kit_colors": "#0046A8,#0046A8,#0046A8,#0046A8,#C40010,#0046A8,#0046A8"
97
}
98
},
99
"deleted": false,
100
"is_placeholder": false,
101
}
102
]
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 8mo ago
Export as PDF
Copy link
Contents
GET Last Updated Fixtures