Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /golf/get_seasons
Returns all (authorized) seasons (that have been recently updated).
Request URL
https://dsg-api.com/clients/{client_name}/golf/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}/golf/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}/golf/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}/golf/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}/golf/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.892.3","sport":"golf","lang":"en","generated_utc":"2025-08-01T15:13:09+00:00","method":{"method_id":"892","name":"get_seasons"},"competition":{"competition_id":"1482","name":"Wyndham Championship","gender":"male","type":"player","format":"tournament","area_id":"203","area_name":"United States","last_updated":"2020-11-10 14:19:25","season":[{"season_id":"74629","title":"2025","original_name":"Wyndham Championship","start_date":"2025-07-31","end_date":"2025-08-03","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2025-02-06 12:29:18"},{"season_id":"69771","title":"2024","original_name":"Wyndham Championship","start_date":"2024-08-08","end_date":"2024-08-11","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2024-06-14 12:14:47"},{"season_id":"66505","title":"2023","original_name":"Wyndham Championship","start_date":"2023-08-03","end_date":"2023-08-06","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2024-06-14 12:14:51"},{"season_id":"53025","title":"2022","original_name":"Wyndham Championship","start_date":"2022-08-04","end_date":"2022-08-07","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2024-06-14 12:14:53"},{"season_id":"46775","title":"2021","original_name":"Wyndham Championship","start_date":"2021-08-12","end_date":"2021-08-15","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2024-06-14 12:14:57"},{"season_id":"31418","title":"2020","original_name":"Wyndham Championship","start_date":"2020-08-13","end_date":"2020-08-16","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2020-04-13 19:00:12"},{"season_id":"19738","title":"2019","original_name":"Wyndham Championship","start_date":"2019-08-01","end_date":"2019-08-04","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2024-06-14 12:15:03"},{"season_id":"15491","title":"2018","original_name":"Wyndham Championship","start_date":"2018-08-16","end_date":"2018-08-19","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2024-06-14 12:15:07"},{"season_id":"13810","title":"2017","original_name":"Wyndham Championship","start_date":"2017-08-17","end_date":"2017-08-20","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1482.png","last_updated":"2017-08-17 12:02:22"}]}}}