No Subscription to this function
GET /beach_volleyball/get_matches
Returns all matches of a particular tournament
Request URL
https://dsg-api.com/clients/{client_name}/beach_volleyball/get_matches?type=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)
id
int Required
object id to return
lang
string
two-character language code, defaults to 'en'
type
string Required
one of ‘season’, ‘round’ or ‘match’ to which the "id" refers
Nodes
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
sport
sport of the API
version
version of the API
group
Details about group
group_id
unique identifier to the group.
last_updated
When group was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of group
match
Details about the particular match
contestant_a1_common_name
common name of the contestant
contestant_a1_first_name
first name of the contestant
contestant_a1_id
unique identifier for the contestant
contestant_a1_last_name
last name of the contestant
contestant_a1_match_name
match name of the contestant
contestant_a1_nationality_area_id
unique area_id of the contestants nationality
contestant_a1_nationality_area_name
nationality of the contestant
contestant_a1_nationality_code
area code of contestants nationality
contestant_a2_common_name
common name of the contestant
contestant_a2_first_name
first name of the contestant
contestant_a2_id
unique identifier for the contestant
contestant_a2_last_name
last name of the contestant
contestant_a2_match_name
match name of the contestant
contestant_a2_nationality_area_id
unique area_id of the contestants nationality
contestant_a2_nationality_area_name
nationality of the contestant
contestant_a2_nationality_code
area code of contestants nationality
contestant_b1_common_name
common name of the contestant
contestant_b1_first_name
first name of the contestant
contestant_b1_id
unique identifier for the contestant
contestant_b1_last_name
last name of the contestant
contestant_b1_match_name
match name of the contestant
contestant_b1_nationality_area_id
unique area_id of the contestants nationality
contestant_b1_nationality_area_name
nationality of the contestant
contestant_b1_nationality_code
area code of contestants nationality
contestant_b2_common_name
common name of the contestant
contestant_b2_first_name
first name of the contestant
contestant_b2_id
unique identifier for the contestant
contestant_b2_last_name
last name of the contestant
contestant_b2_match_name
match name of the contestant
contestant_b2_nationality_area_id
unique area_id of the contestants nationality
contestant_b2_nationality_area_name
nationality of the contestant
contestant_b2_nationality_code
area code of contestants nationality
contestant_team_a_draw_position
darw position of the contestant team
contestant_team_a_id
unique identifier for the contestant team/double
contestant_team_a_seeding
seeding of the contestant team
contestant_team_b_draw_position
darw position of the contestant team
contestant_team_b_id
unique identifier for the contestant team/double
contestant_team_b_seeding
seeding of the contestant team
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
date in UTC timezone, format 'yyyy-mm-dd'.
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match.
score_a
full-time score of home team, including any goals in extra-time
score_b
full-time score of home team, including any goals in extra-time
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'.
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
method
details about the API function
method_id
unique ID of method.
name
name of method.
rounds
Details about round
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.
name
name of round
round_id
unique identifier of round.
start_date
start date, format 'yyyy-mm-dd'.
type
Determines if the round contains a table or a cup structure (knock-out).
set
details about the particular set
num
set number
score_a
score for contestant_a
score_b
score for contestant_b
winner
winner of the particular set
tour
details about a 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"
tournament
details about a specific tournament
area_id
Unique identifier for area.
area_name
name of area the team is located
gender
defines if male or female playing the tournament, additionally mix is possible
season_id
unique identifier of an particular edition of the tournament
season_name
name of the tournament for this particular year (including sponsor names etc)
season_title
title of the season including gender and type (single,double,mix)
status
status of the tournament ('Schedule', 'Postponed', 'Cancelled', 'Live', 'Finished')
tournament_id
unique identifier for a tournament
tournament_name
general name of the tournament (without sponsor names etc)
type
type of tournament at the particular tour
winner_team
unique identifier of the contestant team who won the tournament
winner_team_name
name of the contestant team who won the tournament
tour_season
details about a 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}/beach_volleyball/get_matches?type=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}/beach_volleyball/get_matches?type=season&id={season_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/beach_volleyball/get_matches?type=season&id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success