No Subscription to this function
GET /handball/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}/handball/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
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
match
Details about match
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
final_period
display the period in which the match finished.
match_id
unique identifier of match.
score_a
full-time score of home team
score_b
full-time score of away team
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
team_a_areaname
area name of home team origins county
team_a_id
unique team ID for the home team.
team_a_name
current name of the home team.
team_a_short_name
short name of the home team.
team_a_tla_name
three-letter-acronym of the home team.
team_b_areaname
area name of away team origins county
team_b_id
unique team ID for the away team.
team_b_name
current name of the away team.
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'.
method
details about the API function
method_id
unique ID of method.
name
name of method.
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}/handball/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}/handball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/handball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.1","sport":"handball","lang":"","method":{"method_id":"48","name":"get_matches_day"}}}