Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /rocketleague/get_seasons
Returns all (authorized) seasons (that have been recently updated).
Request URL
https://dsg-api.com/clients/{client_name}/rocketleague/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}
API Threshold
  • 10k calls per hour (2.78 calls per second)
  • This threshold applies to ALL your calls you do across the API.
  • Your number of calls get reset every hour at :00
  • If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
comp_id
int Required
competition id to get seasons from
ftype
string
changes feed type from XML to json (ftype=json or ftype=json_array)
lang
string
two-character language code, defaults to 'en'
Nodes
competition
details about competition
area_id
unique identifier for an area
area_name
name of the area
competition_id
unique identifier for a competition
format
competition format (domestic_league, domestic_cup, domestic_league_cup, domestic_super_cup, international_cup, international_super_cup, playoff, tournament, race, unofficial)
gender
determines the gender of the competition (male or female)
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition
type
determines if a competition is between club teams (club) or national teams (international)
datasportsgroup
details about the API version, sport, language and generation timestamp
generated_utc
UTC timestamp when the API output was generated
lang
language of the API call
sport
sport value
version
version of the API
method
details about the API function
method_id
unique ID of method
name
name of method
season
details about the season
end_date
end date, format 'yyyy-mm-dd'
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
logo
full path URL of logo for particular season
original_name
competition name during this season
season_id
unique identifier for season
start_date
start date, format 'yyyy-mm-dd'
title
title of season
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/rocketleague/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "{User}:{Password}");
$content = curl_exec($ch);
curl_close($ch);
?>
curl GET -u "User:Password" "https://dsg-api.com/clients/{client_name}/rocketleague/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}"
Imports System
Imports System.Net	
Imports System.IO
Imports System.Text

Public Module Module1
	Public Sub Main()
		Dim url As String = "https://dsg-api.com/clients/{client_name}/rocketleague/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}"
		Dim myReq As WebRequest = WebRequest.Create(url)
		myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
		Dim wr As WebResponse = myReq.GetResponse()
		Dim receiveStream As Stream = wr.GetResponseStream()
		Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
		Dim content As String = reader.ReadToEnd()
	End Sub
End Module
response = requests.get("https://dsg-api.com/clients/{client_name}/rocketleague/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.490.3","sport":"esport_rocketleague","lang":"en","generated_utc":"2025-08-01T15:08:25+00:00","method":{"method_id":"490","name":"get_seasons"},"competition":{"competition_id":"2720","name":"RLCS","gender":"male","type":"club","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2021-07-09 11:20:08","season":[{"season_id":"65905","title":"2021\/2022 - Spring Major","original_name":"RLCS","start_date":"2022-06-29","end_date":"2022-07-03","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2022-06-16 06:58:10"},{"season_id":"64914","title":"2021\/2022 - Winter Major","original_name":"RLCS","start_date":"2022-03-23","end_date":"2022-03-28","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2022-03-28 01:00:06"},{"season_id":"64805","title":"2021\/2022 - Winter EU Regional Event 3","original_name":"RLCS","start_date":"2022-02-25","end_date":"2022-02-27","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2022-02-21 20:02:29"},{"season_id":"64753","title":"2021\/2022 - Winter NA Regional Event 3","original_name":"RLCS","start_date":"2022-02-18","end_date":"2022-02-20","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2022-02-14 20:51:50"},{"season_id":"64679","title":"2021\/2022 - Winter EU Regional Event 2","original_name":"RLCS","start_date":"2022-02-04","end_date":"2022-02-06","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2022-02-01 12:42:18"},{"season_id":"64669","title":"2021\/2022 - Winter NA Regional Event 2","original_name":"RLCS","start_date":"2022-01-28","end_date":"2022-01-30","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2022-01-29 08:45:49"},{"season_id":"64623","title":"2021\/2022 - Winter EU Regional Event 1","original_name":"RLCS","start_date":"2022-01-21","end_date":"2022-01-23","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2022-02-01 12:42:38"},{"season_id":"64621","title":"2021\/2022 - Winter NA Regional Event 1","original_name":"RLCS","start_date":"2022-01-14","end_date":"2022-01-16","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2022-01-18 23:14:33"},{"season_id":"61623","title":"2021\/2022 - Fall Major","original_name":"RLCS","start_date":"2021-12-08","end_date":"2021-12-12","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2021-11-23 20:56:37"},{"season_id":"61722","title":"2021\/2022 - EU Regional Event 1","original_name":"RLCS","start_date":"2021-10-22","end_date":"2021-10-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_3.png","last_updated":"2021-11-24 21:48:17"},{"season_id":"50364","title":"Season X Spring - Europe Major","original_name":"RLCS","start_date":"2021-05-15","end_date":"2021-05-16","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-05-16 09:18:22"},{"season_id":"49640","title":"Season X Spring - Europe Regional Event 3","original_name":"RLCS","start_date":"2021-04-15","end_date":"2021-04-18","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-04-19 22:48:58"},{"season_id":"49638","title":"Season X Spring - Europe Regional Event 2","original_name":"RLCS","start_date":"2021-03-25","end_date":"2021-03-28","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-04-19 21:47:21"},{"season_id":"49643","title":"Season X Spring - Europe The Grid","original_name":"RLCS","start_date":"2021-03-22","end_date":"2021-04-13","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_2.png","last_updated":"2021-04-19 23:50:46"},{"season_id":"49148","title":"Season X Spring - Europe Regional Event 1","original_name":"RLCS","start_date":"2021-03-11","end_date":"2021-03-14","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-03-10 20:02:41"},{"season_id":"49065","title":"Season X Winter - NA Major","original_name":"RLCS","start_date":"2021-02-27","end_date":"2021-03-01","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-02-23 09:00:07"},{"season_id":"49046","title":"Season X Winter - Europe Major","original_name":"RLCS","start_date":"2021-02-20","end_date":"2021-02-21","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-02-17 10:04:35"},{"season_id":"48835","title":"Season X - Winter EU Major Q Tiebreaker","original_name":"RLCS","start_date":"2021-01-29","end_date":"2021-01-29","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-02-02 11:04:00"},{"season_id":"48790","title":"Season X Winter - Europe The Grid Week 4","original_name":"RLCS","start_date":"2021-01-21","end_date":"2021-01-22","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_2.png","last_updated":"2021-01-23 11:10:02"},{"season_id":"48784","title":"Season X Winter - Europe Regional Event 3","original_name":"RLCS","start_date":"2021-01-09","end_date":"2021-01-17","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-01-23 02:52:01"},{"season_id":"48789","title":"Season X Winter - Europe The Grid Week 3","original_name":"RLCS","start_date":"2021-01-02","end_date":"2021-01-03","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_2.png","last_updated":"2021-01-23 10:50:17"},{"season_id":"48786","title":"Season X Winter - Europe The Grid Week 2","original_name":"RLCS","start_date":"2020-12-08","end_date":"2020-12-09","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_2.png","last_updated":"2021-01-23 04:08:33"},{"season_id":"48783","title":"Season X Winter - Europe Regional Event 2","original_name":"RLCS","start_date":"2020-12-03","end_date":"2020-12-06","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-01-23 01:51:32"},{"season_id":"48785","title":"Season X Winter - Europe The Grid Week 1","original_name":"RLCS","start_date":"2020-11-26","end_date":"2020-11-27","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_2.png","last_updated":"2021-01-23 03:40:29"},{"season_id":"48612","title":"Season X Winter - Europe Regional Event 1","original_name":"RLCS","start_date":"2020-11-12","end_date":"2020-11-15","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-01-05 13:31:28"},{"season_id":"46395","title":"Season X Fall - Europe Major","original_name":"RLCS","start_date":"2020-10-17","end_date":"2020-10-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2020-10-13 12:45:40"},{"season_id":"48807","title":"Season X Fall - NA Regional Event 3","original_name":"RLCS","start_date":"2020-10-01","end_date":"2020-10-05","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-01-26 03:00:05"},{"season_id":"48794","title":"Season X Fall - NA Regional Event 2","original_name":"RLSC","start_date":"2020-09-12","end_date":"2020-09-21","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-01-25 01:00:05"},{"season_id":"45802","title":"Season X Fall - Europe Regional Event 2","original_name":"RLCS","start_date":"2020-08-29","end_date":"2020-09-06","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2020-09-01 19:23:18"},{"season_id":"45821","title":"Season X Fall - NA Regional Event 1","original_name":"RLCS","start_date":"2020-08-15","end_date":"2020-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720_1.png","last_updated":"2021-01-23 15:00:05"},{"season_id":"31040","title":"Season 9 North America","original_name":"RLCS","start_date":"2020-02-09","end_date":"2020-04-12","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720.png","last_updated":"2022-05-23 21:54:44"},{"season_id":"31039","title":"Season 9 Europe","original_name":"RLCS","start_date":"2020-02-09","end_date":"2020-04-12","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/2720.png","last_updated":"2022-05-23 21:54:19"}]}}}