Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
GET /karate/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}/karate/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
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
discipline
Basic information about the discipline
discipline_id
unique identifier of the discipline
name
name of the discipline
type
type of discipline (contestant or team)
match
Details about the particular match
contestant_a_common_name
common name of the contestant
contestant_a_first_name
first name of the contestant
contestant_a_id
unique identifier for the contestant
contestant_a_last_name
last name of the contestant
contestant_a_match_name
match name of the contestant
contestant_a_nationality
nationality of the contestant
contestant_a_nationality_area_id
unique area_id of the contestants nationality
contestant_a_nationality_area_name
nationality of the contestant
contestant_a_nationality_code
area code of contestant_a nationality
contestant_a_seeding
seeding of the contestant
contestant_b_common_name
common name of the contestant
contestant_b_first_name
first name of the contestant
contestant_b_id
unique identifier for the contestant
contestant_b_last_name
last name of the contestant
contestant_b_match_name
match name of the contestant
contestant_b_nationality
nationality of the contestant
contestant_b_nationality_area_id
unique area_id of the contestants nationality
contestant_b_nationality_area_name
nationality of the contestant
contestant_b_nationality_code
area code of contestant_b nationality
contestant_b_seeding
seeding of the contestant
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
draw_position
darw position of the match
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)
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'.
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.
tournament
details about a specific tournament
area_id
unique identifier for area.
area_name
contains the area name.
end_date
end date, format 'yyyy-mm-dd'.
gender
defines if male or female playing the tournament, additionally mix is possible
logo
full path URL of logo for particular season
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)
start_date
Start date of season, format 'yyyy-mm-dd'.
tournament_id
unique identifier for a tournament
tournament_name
general name of the tournament (without sponsor names etc)
tour_id
unique tour identifier
tour_season_id
unique identifier of a tour season
winner
unique identifier of the contestant who won the tournament
winner_name
name of the contestant who won the tournament
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}/karate/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}/karate/get_matches_day?day={day}&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}/karate/get_matches_day?day={day}&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}/karate/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success