No Subscription to this function
GET /lol/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}/lol/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).
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
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
items
details about the selected items for the particular map
item_1
item_id for the 1st selected item
item_2
item_id for the 2nd selected item
item_3
item_id for the 3rd selected item
item_4
item_id for the 4th selected item
item_5
item_id for the 5th selected item
item_6
item_id for the 6th selected item
item_7
item_id for the 7th selected item
lineup
details of participating player in the particular match
common_name
common name of the player
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
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)
lineup/game_x
details of role and position for the particular map
champion_id
unique identifier for the selected champion
champion_name
name of the selected champion
lane
player lane for the particular match
role
player role for the particular match
spell_1_id
unique identifier for the selected spell
spell_2_id
unique identifier for the selected spell
masteries
details about the selected masteries for the particular map
mastery_1
mastery_id of the first selected mastery
mastery_10
mastery_id of the 10th selected mastery
mastery_10_rank
rank for the selected mastery
mastery_11
mastery_id of the 11th selected mastery
mastery_11_rank
rank for the selected mastery
mastery_1_rank
rank for the selected mastery
mastery_2
mastery_id of the second selected mastery
mastery_2_rank
rank for the selected mastery
mastery_3
mastery_id of the 3rd selected mastery
mastery_3_rank
rank for the selected mastery
mastery_4
mastery_id of the 4th selected mastery
mastery_4_rank
rank for the selected mastery
mastery_5
mastery_id of the 5th selected mastery
mastery_5_rank
rank for the selected mastery
mastery_6
mastery_id of the 6th selected mastery
mastery_6_rank
rank for the selected mastery
mastery_7
mastery_id of the 7th selected mastery
mastery_7_rank
rank for the selected mastery
mastery_8
mastery_id of the 8th selected mastery
mastery_8_rank
rank for the selected mastery
mastery_9
mastery_id of the 9th selected mastery
mastery_9_rank
rank for the selected mastery
match
Details about match
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_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_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.
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).
runes
details about the selected runes for the particular map
rune_1
rune_id for the 1st selected item
rune_1_rank
rank for the selected rune
rune_2
rune_id for the 2nd selected item
rune_2_rank
rank for the selected rune
rune_3
rune_id for the 3rd selected item
rune_3_rank
rank for the selected rune
rune_4
rune_id for the 4th selected item
rune_4_rank
rank for the selected rune
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
stats
detailed stats for the particular map
assists
number of assists
champ_level
Champion Level
combat_player_score
combat player score
deaths
number of deaths
double_kills
number of double kills
first_blood_assist
in case first blood assist then value = true
first_blood_kill
in case first blood kill then value = true
first_inhibitor_assist
in case first inhibitor assist then value = true
first_inhibitor_kill
in case first inhibitor kill then value = true
first_tower_assist
in case first twoer assist then value = true
first_tower_kill
in case first tower kill then value = true
gold earned
total gold earned
gold_spent
total gold spent
inhibitor_kills
total inhibitor kills
killing_spree
number of killing sprees
kills
number of kills
largest_critical_strike
largest critical strike
largest_killing_spree
largest killing spree
largest_multi_kill
largest multi kill
longest_time_spent_living
longest time spent alive (in seconds)
magical_damage_taken
magical damage taken
magic_damage_dealt
magic damage dealt
magic_damage_dealt_to_champions
magic damage dealt to champions
neutral_minions_killed
total neutral minions killed
neutral_minions_killed_enemy_jungle
total neutral minions killed enemy jungle
neutral_minions_killed_team_junle
total neutral minions killed team junle
objective_player_score
objective player score
penta_kills
number of penta kills
physical_damage_dealt
physical damage dealt
physical_damage_dealt_to_champions
physical damage dealt to champions
physical_damage_taken
physical damage taken
quadra_kills
number of quadra kills
sight_wards_bought_in_game
number of sight wards bough in game
total_damage_dealt
total damage dealt
total_damage_dealt_to_champions
total damage dealt to champions
total_damage_taken
total damage taken
total_heal
total heal
total_minions_killed
total total minions killed
total_player_score
total player score
total_score_rank
total score rank
total_time_crowd_control_dealt
total tiem crowd control dealt
total_units_healed
total units healed
triple_kills
number of triple kills
true damage taken
true damage taken
true_damage_dealt
true damage dealt
true_damage_dealt_to_champions
true damage dealt to champions
turret_kills
total turret kills
unreal_kills
number of unreal kills
vision_wards_bought_in_game
number of vision wards bough in game
wards_killed
number of wards killed
wards_placed
number of wards placed
team_stats/game_x
team stats & details per particular map
baron_kills_a
number of baron kills of team_a
baron_kills_b
number of baron kills of team_b
champion_ban_1_a
1st champion banned by team_a
champion_ban_1_b
1st champion banned by team_b
champion_ban_2_a
2nd champion banned by team_a
champion_ban_2_b
2nd champion banned by team_b
champion_ban_3_a
3rd champion banned by team_a
champion_ban_3_a
3rd champion banned by team_a
champion_ban_4_a
4th champion banned by team_a
champion_ban_4_b
4th champion banned by team_b
champion_ban_5_a
5th champion banned by team_a
champion_ban_5_a
5th champion banned by team_b
dominion_victory_score_a
dominion victory score of team_a
dominion_victory_score_b
dominion victory score of team_b
dragon_kills_a
number of baron kills of team_a
dragon_kills_b
number of baron kills of team_b
duration
duration of the particular map (in seconds)
first_baron_a
if team_a killed first baron then value = true
first_baron_b
if team_b killed first baron then value = true
first_blood_a
if team_a drawn first blood then value = true
first_blood_b
if team_b drawn first blood then value = true
first_dragon_a
if team_a killed first dragon then value = true
first_dragon_b
if team_b killed first dragon then value = true
first_inhibitor_a
if team_a destroyed first inhibitor then value = true
first_inhibitor_b
if team_b destroyed first inhibitor then value = true
first_rift_herald_a
if team_a killed first rift herald then value = true
first_rift_herald_b
if team_b killed first rift herald then value = true
first_tower_a
if team_a destroyed first tower then value = true
first_tower_b
if team_b destroyed first tower then value = true
game_mode
game mode of the particular map
game_type
game type of the particular map
game_version
game version of the particular map
inhibitor_kills_a
number of inhibitor kills of team_a
inhibitor_kills_b
number of inhibitor kills of team_b
map
name of the map
rift_herald_kills_a
number of rift herald kills of team_a
rift_herald_kills_b
number of rift herald kills of team_b
tower_kills_a
number of tower kills of team_a
tower_kills_b
number of tower kills of team_b
vilemaw_kills_a
number of vilemaw kills of team_a
vilemaw_kills_b
number of vilemaw kills of team_b
winner_team_id
unique identifier for the winning team for the particular map
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}/lol/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}/lol/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/lol/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success