Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /rugby/get_seasons
Returns all (authorized) seasons (that have been recently updated).
Request URL
https://dsg-api.com/clients/{client_name}/rugby/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}/rugby/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}/rugby/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}/rugby/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}/rugby/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{
- -"datasportsgroup": {
- "version": "2.100.3",
- "sport": "rugby",
- "lang": "en",
- "generated_utc": "2025-08-01T15:04:30+00:00",
- -"method": {
- "method_id": "100",
- "name": "get_seasons"
- -"competition": {
- "competition_id": "1268",
- "name": "World Rugby U20 Championship",
- "gender": "male youth",
- "type": "international",
- "format": "international_cup",
- "area_id": "1",
- "area_name": "World",
- "last_updated": "2025-06-19 21:36:23",
- -"season": [
- -{
- "season_id": "76374",
- "title": "2025 Italy",
- "original_name": "World Rugby U20 Championship",
- "start_date": "2025-06-29",
- "end_date": "2025-07-19",
- "logo": "",
- "last_updated": "2025-06-19 21:39:41"
- -{
- "season_id": "69527",
- "title": "2023 South Africa",
- "original_name": "World Rugby U20 Championship",
- "start_date": "2023-06-24",
- "end_date": "2023-07-14",
- "logo": "",
- "last_updated": "2023-07-25 09:22:33"
- -{
- "season_id": "69526",
- "title": "2019 Argentina",
- "original_name": "World Rugby U20 Championship",
- "start_date": "2019-06-04",
- "end_date": "2019-06-22",
- "logo": "",
- "last_updated": "2023-07-25 08:40:10"
- -{
- "season_id": "70858",
- "title": "2018 France",
- "original_name": "World Rugby U20 Championship",
- "start_date": "2018-05-30",
- "end_date": "2018-06-17",
- "logo": "",
- "last_updated": "2023-11-17 09:18:48"
- -{
- "season_id": "13336",
- "title": "2017 Georgia",
- "original_name": "World Rugby U20 Championship",
- "start_date": "2017-05-31",
- "end_date": "2017-06-18",
- "logo": "",
- "last_updated": "2017-06-09 15:07:50"