No Subscription to this function
GET /water_polo/get_matches_day
Returns all matches with basic data which will be played at the selected day.
Request URL
https://dsg-api.com/clients/{client_name}/water_polo/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
day
string Required
date to obtain matches (yyyy-mm-dd)
detailed
string
only 'yes' is valid. This parameter can be only used in connection with either &round_id= or &last_updated= .
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
last_updated
string
by using valid date time format (yyyy-mm-dd hh:mm:ss) it will display only matches updated after this timestamp. The timestampl cant be older than 6 minutes.
playing
string
only 'yes' is valid to display only current live matches
round_id
int
by using a valid round_id it will filter the todays matches
Nodes
coach
Details about coaches of the particular match
common_name
common name of the person
first_name
first name of the person
last_name
last name of the person
match_name
shortened match name of the person
membership_id
Unique identifier for the membership
nationality
nationality of the person
people_id
unique identifier for person.
team
current team name the coach is member of
team_id
unique identifier of the team the coach is member of
competition
Details about competition
area_name
area name of the competition
competition_area_id
area_id of the competition
competition_id
unique identifier for a competition.
competiton_name
title of the competition
original_name
competition name during this season
parent_area_id
unique identifier of the parent area (either continent or World)
round_id
unique identifier of round.
season_id
unique identifier for season
season_title
title of season
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
event
Details about people events
common_name
common name of the person
event_id
Unique identifier of a player event.
first_name
first name of the person
last_name
last name of the person
match_name
shortened match name of the person
membership_id
Unique identifier for the membership
minute
game minute when event happened (not display for lineups and subs on bench)
nationality
nationality of the person
people_id
unique identifier for person
period
period the score was done (not display for lineups and subs on bench)
position
position of the particular player
second
game second when event happened (not display for lineups and subs on bench)
shirtnumber
shirtnumber at this particular match
team
current team name of players club
team_id
unique identifier for team of the player
type
type of event (depends on the parent node)
match
Details about match
attendance
amount of people that attended the particular match
behinds_a
number of behinds scored by home team
behinds_b
number of behinds scored by away team
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
et_a
extra-time score of home team.
et_b
extra-time score of away team.
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
gameweek
contains the gameweek a match belongs to.
goals_a
number of goals scored by home team
goals_b
number of goals scored by away team
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match.
p1s_a
1st period score of home team.
p1s_b
1st period score of away team.
p2s_a
2nd period score of home team
p2s_b
2nd period score of away team
p3s_a
3rd period score of home team.
p3s_b
3rd period score of away team.
p4s_a
4th period score of home team
p4s_b
4th period score of away team
score_a
full-time score of home team, including any goals in extra-time
score_b
full-time score of away team, including any goals in extra-time
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
team_a_country
three-letter-acronym of the area where the home team origins.
team_a_id
unique team ID for the home team.
team_a_logo
URL to the team logo
team_a_name
current name of the home team.
team_a_original_name
the real name at the particular season (so can differ to current name)
team_a_short_name
short name of the home team.
team_a_tla_name
three-letter-acronym of the home team.
team_b_country
three-letter-acronym of the area where the home team origins.
team_b_id
unique team ID for the away team.
team_b_logo
URL to the team logo
team_b_name
current name of the away team.
team_b_original_name
the real name at the particular season (so can differ to current name)
team_b_short_name
short name of the away team.
team_b_tla_name
three-letter-acronym of the away team.
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'.
venue_city
city where the venue is based
venue_id
unique identifier of the venue
venue_name
current name of the venue
venue_type
determines if the match is on neutral ground or on home/away basis
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.
people
Details about statistics of this player in the particular match
backward_kicks
number of backward kicks
behinds
number of behinds
clearances
number of clearances
common_name
common name of the person
common_name
common name of the person
contestedmarks
number of contested marks
contestedpossessions
number of contested possessions
disposals
number of disposals
effectivekicks
number of effective kicks
errors
number of errors
fifty_metres_penalties
number of 50m penalties
first_name
first name of the person
freesagainst
number of frees against
freesfor
number of frees for
goalassists
number of goal assists
goals
number of goals
handballs
number of handballs
hitouts
number of hit outs
hitouts_to_advantage
number of hit outs to an advantage
ineffective_kicks
number of ineffective kicks
inside50marks
number of inside 50 marks
inside50s
number of inside 50s
kicks
number of kicks
kick_errors
number of kick errors
last_name
last name of the person
marks
number of marks
match_name
shortened match name of the person
minutesplayed
number of minutes played
nationality
nationality of the person
people_id
unique identifier for person.
points
number of points
position
position of the particular player
scoreinvolvements
number of score involvments
shirtnumber
shirtnumber for that particular match
tackles
number of tackles
team
current team name of players club
team_id
unique identifier for team of the player
uncontestedmarks
number of uncontested marks
uncontestedpossessions
number of uncontested possessions
umpire
Details about umpires of the particular match
common_name
common name of the person
first_name
first name of the person
last_name
last name of the person
match_name
shortened match name of the person
nationality
nationality of the person
people_id
unique identifier for person.
type
type of umpire at this particular match
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_matches_day?day={day}&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_matches_day?day={day}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/water_polo/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"water_polo","lang":"","method":{"method_id":"219","name":"get_matches_day"}}}