Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v4 GET /multisport/get_calendar
Returns all rounds/matches of the multisport event season
Request URL
https://dsg-api.com/clients/{client_name}/multisport/get_calendar?id={multisport_event_season_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
area_id
int
filters all items by the country set
authkey
string Required
client authentification key
client
string Required
unique client ID
day
string
date to filter the output (yyyy-mm-dd)
id
int Required
unique multi-sport event season ID
lang
string
two-character language code, defaults to 'en'
sport
string
one or more sports to filter the output (comma-seperated)
Nodes
city❯
information about the city
city_id
unique identifier for cities
city_name
name of the city
competition❯
information about the competition
area_id
unique identifier for an area
area_name
name of the area
competition_id
unique identifier for a competition
competition_name
name of the competition
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
day❯
information about the particular day
date
date format YYYY-MM-DD
method❯
details about the API function
method_id
unique ID of method
name
name of method
multisport_event❯
basic informations about the multisport event
area_code
three character area code
area_id
unique identifier for an area
area_name
name of the area
gender
determines the gender of the competition (male or female)
multisport_event_id
unique identifier for multisport events
multisport_event_name
general name of the multisport events
multisport_event_season❯
basic informations about the multisport event season
end_date
end date, format 'yyyy-mm-dd'
multisport_event_season_id
unique identifier for multisport event season
multisport_event_season_name
general name of the multisport event season
start_date
start date, format 'yyyy-mm-dd'
season_extra❯
extra information of the season
status
status of the season (Scheduled,Live,Played,Postponed,Cancelled,Break)
surface
type of surface (grass, artificial turf, ice, sand, water, parquet, asphalt, snow, canvas, hard)
type
type of tournament at the particular tour
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}/multisport/get_calendar?id={multisport_event_season_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}/multisport/get_calendar?id={multisport_event_season_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}/multisport/get_calendar?id={multisport_event_season_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}/multisport/get_calendar?id={multisport_event_season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success