No Subscription to this function
GET /fifa/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}/fifa/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.
pstats
string
'yes' and 'no' are valid, enables/disables player stat nodes
startdate
string
start date, format 'yyyy-mm-dd' (requires enddate to take effect)
timestamp
string
'yyyy-mm-dd hh:mm:ss', will display only events after this timestamp
type
string Required
one of ‘season’, ‘round’ or ‘match’ to which the "id" refers
Nodes
competition
Details about competition
area_id
unique identifier for area.
area_name
contains the area name.
competition_id
unique identifier for a competition.
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).
game
Details about games played as part of the match
console
type of console - PS4 or XBox as valid values
contestant_a1_common_name
common name of the contestant
contestant_a1_first_name
first name of the contestant
contestant_a1_id
unique identifier for the contestant
contestant_a1_last_name
last name of the contestant
contestant_a1_nationality_area_id
unique area_id of the contestants nationality
contestant_a1_nationality_area_name
nationality of the contestant
contestant_a1_nationality_code
area code of contestants nationality
contestant_a2_common_name
common name of the contestant
contestant_a2_first_name
first name of the contestant
contestant_a2_id
unique identifier for the contestant
contestant_a2_last_name
last name of the contestant
contestant_a2_nationality_area_id
unique area_id of the contestants nationality
contestant_a2_nationality_area_name
nationality of the contestant
contestant_a2_nationality_code
area code of contestants nationality
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_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 contestants nationality
contestant_b1_common_name
common name of the contestant
contestant_b1_first_name
first name of the contestant
contestant_b1_id
unique identifier for the contestant
contestant_b1_last_name
last name of the contestant
contestant_b1_match_name
match name of the contestant
contestant_b1_match_name
match name of the contestant
contestant_b1_nationality_area_id
unique area_id of the contestants nationality
contestant_b1_nationality_area_name
nationality of the contestant
contestant_b1_nationality_code
area code of contestants nationality
contestant_b2_common_name
common name of the contestant
contestant_b2_first_name
first name of the contestant
contestant_b2_id
unique identifier for the contestant
contestant_b2_last_name
last name of the contestant
contestant_b2_match_name
match name of the contestant
contestant_b2_match_name
match name of the contestant
contestant_b2_nationality_area_id
unique area_id of the contestants nationality
contestant_b2_nationality_area_name
nationality of the contestant
contestant_b2_nationality_code
area code of contestants nationality
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_match_name
match name 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 contestants nationality
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
ets_a
extra-time score of home team
ets_b
extra-time score of away team
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
game_id
unique identifier of game.
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
p1s_a
half-time score of home team.
p1s_b
half-time score of away team.
p2s_a
2nd half score of home team
p2s_b
2nd half score of away team
pen_a
penalty shootout score of home team
pen_b
penalty shootout score of away team
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)
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'.
versus_type
type of game - 1vs1 and 2vs2 as valid values
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
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 next matches of the particular team
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
gameweek
contains the gameweek a match belongs to.
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.
playoff
Groups two or more matches to represent aggregate game.
playoff_id
unique identifier of the playoff
playoff_score_a
playoff score of home team in first game
playoff_score_b
playoff score of away team in first game
type
type of playoff, either "scores" or "wins"
winner_team_id
uniqe identifier of the team which advanced the playoff
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
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}/fifa/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}/fifa/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/fifa/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success