Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /netball/get_matches
Returns all matches (and related events) that belong to a season, round or match
Request URL
https://dsg-api.com/clients/{client_name}/netball/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}
API Threshold
  • 10k calls per hour (2.78 calls per second)
  • This threshold applies to ALL your calls you do across the API.
  • Your number of calls get reset every hour at :00
  • If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)
Parameters
age
string
unique identifier for an age group
discipline_id
int
unique identifier for a discipline
gender
string
unique identifier for a gender (male,female)
team_id
int
use a team_id as value to filter the matches accordingly
Nodes
competition❯
details about competition
area_id
unique identifier for an area
area_name
name of the area
competition_id
unique identifier for a competition
format
competition format (domestic_league, domestic_cup, domestic_league_cup, domestic_super_cup, international_cup, international_super_cup, playoff, tournament, race, unofficial)
gender
determines the gender of the competition (male or female)
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition
type
determines if a competition is between club teams (club) or national teams (international)
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
membership_id
unique identifier for the membership
minute
game minute when event happened (not display for lineups and subs on bench)
minute_extra
game minute of event after regular time o the period
nationality
nationality of the person
nationality_area_id
unique identifier for an area
people_id
unique identifier for person
period
period type
position
position value
role
type of role ('player', 'coach' or 'assistant_coach', 'goalkeeper_coach', 'local_coach', 'scout', 'sporting director')
second
game second when event happened (not display for lineups and subs on bench)
shirtnumber
shirtnumber value
short_name
shortened name of the person
team_id
unique identifier of the team
team_name
current team name
type
type of event (depends on the parent node)
list❯
details about list type
aggregation_type
aggregation type (scores or wins)
id
unique identifier for a group if type = group, if type = playoff then for a playoff
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of either a group or playoff
score_a
playoff score of team_a
score_b
playoff score of team_b
type
list type (regular, group or playoff)
winner_team_id
unique identifier for the winning team of the playoff
match❯
details about the 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.
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 team_a
score_b
full-time score of team_b
status
status of the game (Played, Playing, Fixture, Cancelled, Postponed, Suspended, Awarded, Break, Retired, Bye, No Contest, Disqualified, Tech Knockout, Knockout, Draw, Submission) + (Cricket-specific = No Result, Tea, Lunch, Dinner, between Innings, Stumps, rain delay, bad light, crowd trouble, pitch condition, start delay, drinks, super over, floodlight failure)
team_a_area_code
three-letter-acronym of the area where the home team origins
team_a_area_id
unique area_id for team_a
team_a_area_name
area name of home team origins county
team_a_id
unique team ID for team_a
team_a_logo
team logo URL
team_a_name
current name of team_a
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 team_a
team_b_area_code
three-letter-acronym of the area where the home team origins
team_b_area_id
unique area_id for team_b
team_b_area_name
area name of away team origins county
team_b_id
unique team ID for team_b
team_b_logo
team logo URL
team_b_name
current name of team_b
team_b_original_name
the real name at the particular season (so can differ to current name)
team_b_short_name
short name of team_b
team_b_tla_name
three-letter-acronym of team_b
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'
venue_type
determines if the match is on neutral ground or on home/away basis (home_away or neutral)
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
round❯
details about the round
end_date
end date, format 'yyyy-mm-dd'
end_date_utc
end date in UTC timezone, format 'yyyy-mm-dd'
end_time
end time, format 'HH:mm:ss'
end_time_utc
end time in UTC timezone, format 'HH:mm:ss'
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'
start_date_utc
start date in UTC timezone, format 'yyyy-mm-dd'.
start_time
start time, format 'HH:mm:ss'
start_time_utc
start time in UTC timezone, format 'HH:mm:ss'
type
determines if the round contains a table or a cup structure (knock-out)
round_extra❯
extra round information
current_gameweek
displays the gameweek of nearest match to today
medal_round
indicates if medals are awarded in this round
status
status of the round (Scheduled,Live,Played,Postponed,Cancelled,Break)
total_gameweek
displays the total of gameweeks for this round
season❯
details about the season
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.
logo
full path URL of logo for particular season
original_name
competition name during this season
season_id
unique identifier for season
start_date
start date, format 'yyyy-mm-dd'
title
title of 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}/netball/get_matches?type={type}&id={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}/netball/get_matches?type={type}&id={id}&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}/netball/get_matches?type={type}&id={id}&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}/netball/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success