Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v2 GET /water_polo/get_rounds
Returns all available rounds for a certain season.
Request URL
https://dsg-api.com/clients/{client_name}/water_polo/get_rounds?season_id={season_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
season_id
int Required
season to get the rounds from
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
discipline❯
basic information about the discipline
discipline_id
unique identifier of the discipline
name
name of the discipline
type
type of discipline (contestant, contestant_team or team)
gender❯
details about the gender
age_group
defines the age group (senior,u23,u22,u21....)
value
gender type (male, female or mixed)
group❯
details about list group
group_id
unique identifier to the group
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of group
method❯
details about the API function
method_id
unique ID of method
name
name of method
round❯
details about the round
end_date
end date, format 'yyyy-mm-dd'
end_date_utc
end date in UTC timezone, format 'yyyy-mm-dd'
end_time
end time, format 'HH:mm:ss'
end_time_utc
end time in UTC timezone, format 'HH:mm:ss'
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of round
round_id
unique identifier of round
start_date
start date, format 'yyyy-mm-dd'
start_date_utc
start date in UTC timezone, format 'yyyy-mm-dd'.
start_time
start time, format 'HH:mm:ss'
start_time_utc
start time in UTC timezone, format 'HH:mm:ss'
type
determines if the round contains a table or a cup structure (knock-out)
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
tour❯
details about the tour
gender
gender of the tour
name
name of the particular tour
tour_id
unique tour identifier
tour_type
defines if the tournament is part of a tour or not. If not then value "non-tour"
tour_season❯
details about a tour season
logo
full path URL of logo for particular tour_season
name
name of the tour_season
title
title of the particular tour season
tour_season_id
unique identifier of a tour 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}/water_polo/get_rounds?season_id={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}/water_polo/get_rounds?season_id={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}/water_polo/get_rounds?season_id={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}/water_polo/get_rounds?season_id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example200 Success{"datasportsgroup":{"version":"2.0","sport":"water_polo","lang":"en","method":{"method_id":"215","name":"get_rounds"},"competition":{"competition_id":"1961","name":"FINA World Cup","teamtype":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2019-06-09 18:57:45","season":{"season_id":"18084","title":"2018 Berlin","original_name":"FINA World Cup","start_date":"2018-09-11","end_date":"2018-09-16","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-09-11 13:26:51","rounds":[{"round_id":"24153","name":"Preliminary Round","start_date":"2018-09-11","end_date":"2018-09-13","type":"table","current_gameweek":"","last_updated":"2018-09-07 13:54:53","group":[{"group_id":"6326","name":"Group 1","last_updated":"2018-09-07 13:56:38"},{"group_id":"6327","name":"Group 2","last_updated":"2018-09-07 13:56:43"}]},{"round_id":"24154","name":"Quarter-finals","start_date":"2018-09-14","end_date":"2018-09-14","type":"cup","current_gameweek":"","last_updated":"2018-09-07 13:54:35"},{"round_id":"24155","name":"5th Place Playoff","start_date":"2018-09-15","end_date":"2018-09-15","type":"cup","current_gameweek":"","last_updated":"2018-09-07 13:54:35"},{"round_id":"24156","name":"Semi-finals","start_date":"2018-09-15","end_date":"2018-09-15","type":"cup","current_gameweek":"","last_updated":"2018-09-07 13:54:35"},{"round_id":"24157","name":"7th Place","start_date":"2018-09-16","end_date":"2018-09-16","type":"cup","current_gameweek":"","last_updated":"2018-09-07 13:54:35"},{"round_id":"24158","name":"5th Place","start_date":"2018-09-16","end_date":"2018-09-16","type":"cup","current_gameweek":"","last_updated":"2018-09-07 13:54:35"},{"round_id":"24159","name":"3rd Place","start_date":"2018-09-16","end_date":"2018-09-16","type":"cup","current_gameweek":"","last_updated":"2018-09-07 13:54:35"},{"round_id":"24160","name":"Final","start_date":"2018-09-16","end_date":"2018-09-16","type":"cup","current_gameweek":"","last_updated":"2018-09-07 13:54:35"}]}}}}