Schedules
Last updated
Was this helpful?
Last updated
Was this helpful?
Display complete season schedules for your favourite leagues and teams. The schedule endpoints allow you to quickly retrieve the up-to-date season schedules that interest you.
You can choose a variety of endpoints to retrieve the season schedules.
This section will briefly discuss all the options available to request schedules.
An overview of all available options:
GET Schedules by Season ID: returns the complete season schedule from your requested season id.
GET Schedules by Team ID: returns the complete schedule for the active seasons from your requested team id.
GET Schedules by Season ID and Team ID: returns the complete season schedule for one specific team from your requested season id.
For all the schedules endpoints the base URL is the same:
https://api.sportmonks.com/v3/football/schedules
Per endpoint the rest of the URL requires additional information. We will explain this per endpoint.
The is the perfect endpoint to retrieve the full season schedule of the season you’re interested in. For example, if you’re interested in the full season schedule of the Danish Superliga.
You need to add the season id to your request:
https://api.sportmonks.com/v3/football/schedules/seasons/{season_id}
First, you will need to retrieve the league id and active season id of the Danish Superliga. As you’ve learnt in our , you can easily retrieve the league and season ids in multiple ways. Please check these tutorials for more info.
The league id of the Danish Superliga is 271, and the active season id is 19686. Now, you can use this season id to retrieve the full schedule.
As you can see, the response contains all the fixtures of the requested season. This is suited to display the full schedule in your application. You can also retrieve the schedule of your favourite teams.
You need to add the team id to your schedule request:
https://api.sportmonks.com/v3/football/schedules/teams/{team_id}
So for example, if you’re interested in the full-season schedule for Rangers (team id: 62):
You need to add the season id and team id to your schedule request:
https://api.sportmonks.com/v3/football/schedules/seasons/{season_id}/teams/{team_id}
So for example, if you’re interested in the full-season schedule for Rangers (team id: 62) in the Scottish Premiership (season id 19735):
In the next section, we’ll explain a few more things about the structure of the season.
There are no include options for the schedule endpoints.
There are limited selecting options available.
Retrieve the full season schedule of your favourite teams with the . This endpoint returns the complete schedule of all active seasons the team is in. Let’s take a look at how this works.
Please note that the response is based on the leagues in your plan. Therefore, if you’re missing a specific league, it’s possible that you don’t have access to it. Check our for more info.
If you’re only interested in the schedule of a specific team in a specific league, the is best suited.
Retrieve the full season schedule of your favourite teams in a specific season with the . This endpoint returns the complete schedule of one team in the requested season.