No Subscription to this function
GET /basketball/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}/basketball/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
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. ('soc_p2s','soc_ets','soc_pen')
game_minute
display during a live match the current game minute
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 away team, including any goals in extra-time
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
Rate limit exceeded
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/basketball/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}/basketball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/basketball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.1","sport":"basketball","lang":"","method":{"method_id":"48","name":"get_matches_day"},"competition":{"competition_id":"2341","competition_name":"WNBA","competition_area_id":"203","area_name":"United States","season_id":"21406","season_title":"2019","round_id":"31657","parent_area_id":"4","match":{"match_id":"1631088","date":"2019-08-08","time":"02:00:00","date_utc":"2019-08-08","time_utc":"00:00:00","team_a_id":"40818","team_a_name":"Chicago Sky","team_a_short_name":"Chicago Sky","team_a_tla_name":"CHI","team_a_original_name":"Chicago Sky","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/40818.png","team_b_id":"40821","team_b_name":"New York Liberty","team_b_short_name":"NY Liberty","team_b_tla_name":"NYL","team_b_original_name":"New York Liberty","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/40821.png","status":"Played","gameweek":"","winner":"team_A","score_a":"101","score_b":"92","p1s_a":"21","p1s_b":"24","p2s_a":"21","p2s_b":"25","p3s_a":"17","p3s_b":"11","p4s_a":"42","p4s_b":"32","venue_type":"home_away","final_period":"bkb_p4s","attendance":"","venue_id":"14615","venue_name":"Wintrust Arena","venue_city":"Chicago, IL","last_updated":"2019-08-08 07:46:28","final":"no"}}}}