No Subscription to this function
GET /softball/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}/softball/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
detailed
string
only 'yes' is valid to display additional match details
enddate
string
end date, format 'yyyy-mm-dd' (requires startdate to take effect)
ftype
string
changes feed type from XML to json (ftype=json)
gameweek
int
gameweek value to get matches from
id
int Required
object id to return
lang
string
two-character language code, defaults to 'en'
picsize
string
one of 200x200, 100x100, 50x50, 30x30 or 18x18 to get correct size of club logo.
startdate
string
start date, format 'yyyy-mm-dd' (requires enddate to take effect)
type
string Required
one of ‘season’, ‘round’ or ‘match’ to which the "id" refers
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_id
unique identifier for area.
area_name
contains the area name.
competition_id
unique identifier for a competition.
cricket_type
valid values are "T20", "ODI" and "Test"
format
competition format to filter out leagues or cups
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition.
teamtype
determines the type of team/competition (male,female,male_youth,female_youth)
type
determines if a competition is between club teams (club) or national teams (international).
event
Details about people events (line-up and subs on bench)
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
nationality
nationality of the person
people_id
unique identifier for person
position
position of the particular player
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)
group
Details about group
group_id
unique identifier to the group.
last_updated
When group was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of group
match
Details about match
attendance
amount of people that attended the particular match
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
errors_a
number of errors for home team
errors_b
number of errors for 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.
hits_a
number of hits for home team
hits_b
number of hits for 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.
runs_ep1s_a
1st extra-inning score of home team.
runs_ep1s_b
1st extra-inning score of away team.
runs_ep2s_a
2nd extra-inning score of home team.
runs_ep2s_b
2nd extra-inning score of away team.
runs_ep3s_a
3rd extra-inning score of home team.
runs_ep3s_b
3rd extra-inning score of away team.
runs_ep4s_a
4th extra-inning score of home team.
runs_ep4s_b
4th extra-inning score of away team.
runs_ep5s_a
5th extra-inning score of home team.
runs_ep5s_b
5th extra-inning score of away team.
runs_ep6s_a
6th extra-inning score of home team.
runs_ep6s_b
6th extra-inning score of away team.
runs_ep7s_a
7th extra-inning score of home team.
runs_ep7s_b
7th extra-inning score of away team.
runs_ep8s_a
8th extra-inning score of home team.
runs_ep8s_b
8th extra-inning score of away team.
runs_ep9s_a
9th extra-inning score of home team.
runs_ep9s_b
9th extra-inning score of away team.
runs_p1s_a
1st inning score of home team.
runs_p1s_b
1st inning score of away team.
runs_p2s_a
2nd inning score of hometeam.
runs_p2s_b
2nd inning score of away team.
runs_p3s_a
3rd inning score of home team.
runs_p3s_b
3rd inning score of away team.
runs_p4s_a
4th inning score of home team.
runs_p4s_b
4th inning score of away team.
runs_p5s_a
5th inning score of home team.
runs_p5s_b
5th inning score of away team.
runs_p6s_a
6th inning score of home team.
runs_p6s_b
6th inning score of away team.
runs_p7s_a
7th inning score of home team.
runs_p7s_b
7th inning score of away team.
runs_p8s_a
8th inning score of home team.
runs_p8s_b
8th inning score of away team.
runs_p9s_a
9th inning score of home team.
runs_p9s_b
9th inning score of away team.
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')
people
Details about statistics of this player in the particular match
assists
number of assist
atbat
number of atbats
baseonballs
number of base on balls
bataverage
bat average value
caughtstealing
number of caught stealing
common_name
common name of the person
doubles
number of doubles
errors
number of errors
fieldingpercentage
fielding percentage value
first_name
first name of the person
flyouts
number of fly outs
groundouts
number of ground outs
hitbypitch
number of hit by pitch
homeruns
number of home runs
homerunstotal
number of home runs (season total including this game)
last_name
last name of the person
leftonbase
number of left on base
match_name
shortened match name of the person
nationality
nationality of the person
onbasepercentage
on base percentage value
onbasesluggingpercentage
on base slugging percentage value
people_id
unique identifier for person
position
position of the particular player
putouts
number of put outs
rbitotal
number of runs batted in (season total including this game)
runsbattedin
number of runs batted in
sacrificeflies
number of sacrifice flies
sacrificehit
number of sacrifice hits
sluggingpercentage
slugging percentage value
stolenbases
number of stolen bases
strikeout
number of strike out
team
current team name of players club
team_id
unique identifier for team of the player
totalbases
number of total bases
totalhits
number of total hits
totalruns
number of total runs
triples
number of triples
rounds
Details about round
current_gameweek
displays the gameweek of nearest match to today
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.
name
name of round
round_id
unique identifier of round.
start_date
start date, format 'yyyy-mm-dd'.
type
Determines if the round contains a table or a cup structure (knock-out).
season
Details about 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
umpire_1b
Details about 1st base umpire 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.
umpire_2b
Details about 2nd base umpire 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.
umpire_3b
Details about 3rd base umpire 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.
umpire_hp
Details about main umpire 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.
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}/softball/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}/softball/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/softball/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success