No Subscription to this function
GET /field_hockey/get_peoples
Returns person informations and list of teams the person were member of.
Request URL
https://dsg-api.com/clients/{client_name}/field_hockey/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json)
id
int Required
player id to return
lang
string
two-character language code, defaults to 'en'
Nodes
competition
player statistics per competition
appearances
number of appearances (starting 11 + sub in)
competition_id
unique identifier for a competition.
competition_name
name of the competition.
comp_area_id
unique identifier for area.
comp_format
competition format to filter out leagues or cups
field_goals
number of field goals
goals
number of goals
green_cards
number of green cards
lineups
number of lineups
penalty_corners
number of penalty corners
penalty_strike_goals
number of penalty strike goals
red_cards
number of red cards
subs_on_bench
number of subs on bench
yellow_cards
number of yellow cards
main_club_career
player statistics in all club competitions
appearances
number of appearances (starting 11 + sub in)
field_goals
number of field goals
goals
number of goals
green_cards
number of green cards
lineups
number of lineups
penalty_corners
number of penalty corners
penalty_strike_goals
number of penalty strike goals
red_cards
number of red cards
subs_on_bench
number of subs on bench
yellow_cards
number of yellow cards
main_national_team_career
player statistics in all national team competitions
appearances
number of appearances (starting 11 + sub in)
field_goals
number of field goals
goals
number of goals
green_cards
number of green cards
lineups
number of lineups
penalty_corners
number of penalty corners
penalty_strike_goals
number of penalty strike goals
red_cards
number of red cards
subs_on_bench
number of subs on bench
yellow_cards
number of yellow cards
match
Details about match
attendance
amount of people that attended the particular match
behinds_a
number of behinds scored by home team
behinds_b
number of behinds scored by away team
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
et_a
extra-time score of home team.
et_b
extra-time score of 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.
goals_a
number of goals scored by home team
goals_b
number of goals scored by 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.
p1s_a
1st period score of home team.
p1s_b
1st period score of away team.
p2s_a
2nd period score of home team
p2s_b
2nd period score of away team
p3s_a
3rd period score of home team.
p3s_b
3rd period score of away team.
p4s_a
4th period score of home team
p4s_b
4th period score of away team
round_id
unique identifier of round.
score_a
full-time score of home team, including any goals in extra-time
score_b
full-time score of away team, including any goals in extra-time
season_id
unique identifier of season.
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'.
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')
membership
Membership handles the relation from a person to a team
active
Determines if person is still at the team ('yes') or not ('no').
end_date
End date of membership, format 'yyyy-mm-dd'.
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS. CET timezone.
membership_id
Unique identifier for the membership
role
type of role ('player', 'coach' or 'assistant_coach', 'goalkeeper_coach', 'local_coach', 'scout', 'sporting director')
short_name
short name of the team.
start_date
Start date of membership, format 'yyyy-mm-dd'.
team_area
area name where team is located
team_area_id
unique identifier for an area
team_id
Unique identifier for team
team_name
current team name
type
type of the team ('club', 'national' or 'selection')
method
details about the API function
method_id
unique ID of method.
name
name of method.
people
Basic information about the person
common_name
common name of the person
country_of_birth
name of the country the person was born
date_of_birth
birth date of the person
first_name
first name of the person
gender
gender of the person ('male' or 'female')
height
Height of person in centimeters
last_name
last name of the person
match_name
shortened match name of the person
nationality
current nationality of the person
people_id
unique identifier for person
place_of_birth
name of city the person was born
player_picture
full path URL of player headshot, size can be changed via the picsize parameter
position
position of the player
weight
Weight of person in kilograms.
season_statistic
player statistics per season
appearances
number of appearances (starting 11 + sub in)
competition_name
name of the competition.
comp_area_id
unique identifier for area.
comp_format
competition format to filter out leagues or cups
field_goals
number of field goals
goals
number of goals
green_cards
number of green cards
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
lineups
number of lineups
original_name
competition name during this season
penalty_corners
number of penalty corners
penalty_strike_goals
number of penalty strike goals
red_cards
number of red cards
season_id
unique identifier for season
shirtnumber
shirtnumber for the particular season
subs_on_bench
number of subs on bench
title
title of season
yellow_cards
number of yellow cards
youth_club_career
player statistics in all youth club competitions
appearances
number of appearances (starting 11 + sub in)
field_goals
number of field goals
goals
number of goals
green_cards
number of green cards
lineups
number of lineups
penalty_corners
number of penalty corners
penalty_strike_goals
number of penalty strike goals
red_cards
number of red cards
subs_on_bench
number of subs on bench
yellow_cards
number of yellow cards
youth_national_team_career
player statistics in all youth national team competitions
appearances
number of appearances (starting 11 + sub in)
field_goals
number of field goals
goals
number of goals
green_cards
number of green cards
lineups
number of lineups
penalty_corners
number of penalty corners
penalty_strike_goals
number of penalty strike goals
red_cards
number of red cards
subs_on_bench
number of subs on bench
yellow_cards
number of yellow cards
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}/field_hockey/get_peoples?id={people_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}/field_hockey/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/field_hockey/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"field_hockey","lang":"en","method":{"method_id":"201","name":"get_peoples"},"people":{"people_id":"259941","first_name":"Johan","last_name":"Durst","match_name":"J. Durst","common_name":"Johan Durst","date_of_birth":"1991-03-18","place_of_birth":"Canterbury, NSW","country_of_birth":"Australia","nationality":"Australia","gender":"male","height":"","weight":"","position":"Goalkeeper","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/259941.png","career_summary":{"main_club_career":[],"youth_club_career":[],"main_national_team_career":{"appearances":"3","lineups":"0","subs_on_bench":"11","goals":"0","field_goals":"0","penalty_corners":"0","penalty_strike_goals":"0","green_cards":"0","yellow_cards":"0","red_cards":"0","competition":[{"competition_id":"2156","competition_name":"FIH Pro League","comp_area_id":"1","comp_format":"international_cup","appearances":"3","lineups":"0","subs_on_bench":"5","goals":"0","field_goals":"0","penalty_corners":"0","penalty_strike_goals":"0","green_cards":"0","yellow_cards":"0","red_cards":"0"},{"competition_id":"1958","competition_name":"Hockey Champions Trophy","comp_area_id":"1","comp_format":"international_cup","appearances":"0","lineups":"0","subs_on_bench":"6","goals":"0","field_goals":"0","penalty_corners":"0","penalty_strike_goals":"0","green_cards":"0","yellow_cards":"0","red_cards":"0"}]},"youth_national_team_career":[]},"trophies_team":{"competition":{"competition_id":"1958","title":"Hockey Champions Trophy","season":{"season_id":"16921","title":"2018 Netherlands","name":"Rabobank Hockey Champions Trophy"}}},"membership":{"membership_id":"2709247","team_id":"36640","team_name":"Australia","short_name":"Australia","team_area":"Australia","type":"national","start_date":"2018-06-01","end_date":"","role":"player","active":"yes","last_updated":"2019-02-02 13:44:12","season_statistic":[{"season_id":"20345","title":"2019","competition_name":"FIH Pro League","original_name":"FIH Pro League","comp_area_id":"1","comp_format":"international_cup","appearances":"3","subs_on_bench":"5","lineups":"0","goals":"0","field_goals":"0","penalty_corners":"0","penalty_strike_goals":"0","green_cards":"0","yellow_cards":"0","red_cards":"0","shirtnumber":"8","last_updated":"2019-03-09 12:00:03"},{"season_id":"16921","title":"2018 Netherlands","competition_name":"Hockey Champions Trophy","original_name":"Hockey Champions Trophy","comp_area_id":"1","comp_format":"international_cup","appearances":"0","subs_on_bench":"6","lineups":"0","goals":"0","field_goals":"0","penalty_corners":"0","penalty_strike_goals":"0","green_cards":"0","yellow_cards":"0","red_cards":"0","shirtnumber":"8","last_updated":"2018-12-03 14:09:24"}]},"last_matches":{"match":[{"match_id":"1362358","competition_id":"1958","season_id":"16921","round_id":"22623","date":"2018-07-01","time":"16:00:00","date_utc":"2018-07-01","time_utc":"14:00:00","team_a_id":"36640","team_a_name":"Australia","team_a_short_name":"Australia","team_a_tla_name":"AUS","team_a_original_name":"Australia","team_a_country":"AUS","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36640.png","team_b_id":"36651","team_b_name":"India","team_b_short_name":"India","team_b_tla_name":"IND","team_b_original_name":"India","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36651.png","status":"Played","gameweek":"","winner":"draw","score_a":"1","score_b":"1","p1s_a":"0","p1s_b":"0","p2s_a":"1","p2s_b":"0","et_a":"","et_b":"","pen_a":"3","pen_b":"1","venue_type":"home_away","final_period":"fhk_pen","attendance":"","venue_id":"12457","venue_name":"BH & BC Breda","venue_city":"Breda","last_updated":"2019-01-13 16:37:30"},{"match_id":"1520772","competition_id":"2156","season_id":"20345","round_id":"27674","date":"2019-02-02","time":"05:00:00","date_utc":"2019-02-02","time_utc":"04:00:00","team_a_id":"36640","team_a_name":"Australia","team_a_short_name":"Australia","team_a_tla_name":"AUS","team_a_original_name":"Australia","team_a_country":"AUS","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36640.png","team_b_id":"36646","team_b_name":"Netherlands","team_b_short_name":"Netherlands","team_b_tla_name":"NED","team_b_original_name":"Netherlands","team_b_country":"NLD","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36646.png","status":"Played","gameweek":"","winner":"team_B","score_a":"5","score_b":"5","p1s_a":"2","p1s_b":"1","p2s_a":"2","p2s_b":"1","et_a":"","et_b":"","pen_a":"1","pen_b":"4","venue_type":"home_away","final_period":"fhk_pen","attendance":"","venue_id":"13889","venue_name":"State Netball and Hockey Centre","venue_city":"Melbourne, VIC","last_updated":"2019-04-23 14:46:57"},{"match_id":"1520774","competition_id":"2156","season_id":"20345","round_id":"27674","date":"2019-02-03","time":"05:00:00","date_utc":"2019-02-03","time_utc":"04:00:00","team_a_id":"36640","team_a_name":"Australia","team_a_short_name":"Australia","team_a_tla_name":"AUS","team_a_original_name":"Australia","team_a_country":"AUS","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36640.png","team_b_id":"36648","team_b_name":"Belgium","team_b_short_name":"Belgium","team_b_tla_name":"BEL","team_b_original_name":"Belgium","team_b_country":"BEL","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36648.png","status":"Played","gameweek":"","winner":"team_B","score_a":"1","score_b":"4","p1s_a":"1","p1s_b":"1","p2s_a":"0","p2s_b":"1","et_a":"","et_b":"","pen_a":"","pen_b":"","venue_type":"home_away","final_period":"fhk_p4s","attendance":"","venue_id":"13889","venue_name":"State Netball and Hockey Centre","venue_city":"Melbourne, VIC","last_updated":"2019-02-03 12:13:25"},{"match_id":"1520777","competition_id":"2156","season_id":"20345","round_id":"27674","date":"2019-02-10","time":"05:00:00","date_utc":"2019-02-10","time_utc":"04:00:00","team_a_id":"36640","team_a_name":"Australia","team_a_short_name":"Australia","team_a_tla_name":"AUS","team_a_original_name":"Australia","team_a_country":"AUS","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36640.png","team_b_id":"36647","team_b_name":"Germany","team_b_short_name":"Germany","team_b_tla_name":"GER","team_b_original_name":"Germany","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36647.png","status":"Played","gameweek":"","winner":"team_A","score_a":"4","score_b":"2","p1s_a":"1","p1s_b":"1","p2s_a":"1","p2s_b":"1","et_a":"","et_b":"","pen_a":"","pen_b":"","venue_type":"home_away","final_period":"fhk_p4s","attendance":"","venue_id":"13891","venue_name":"Tasmanian Hockey Centre","venue_city":"Hobart, TAS","last_updated":"2019-03-09 10:03:43"},{"match_id":"1520780","competition_id":"2156","season_id":"20345","round_id":"27674","date":"2019-02-16","time":"05:30:00","date_utc":"2019-02-16","time_utc":"04:30:00","team_a_id":"36640","team_a_name":"Australia","team_a_short_name":"Australia","team_a_tla_name":"AUS","team_a_original_name":"Australia","team_a_country":"AUS","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36640.png","team_b_id":"36641","team_b_name":"Great Britain","team_b_short_name":"Great Britain","team_b_tla_name":"GBR","team_b_original_name":"Great Britain","team_b_country":"GBR","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36641.png","status":"Played","gameweek":"","winner":"team_A","score_a":"2","score_b":"0","p1s_a":"1","p1s_b":"0","p2s_a":"1","p2s_b":"0","et_a":"","et_b":"","pen_a":"","pen_b":"","venue_type":"home_away","final_period":"fhk_p4s","attendance":"","venue_id":"13892","venue_name":"Perth Hockey Stadium","venue_city":"Perth, WA","last_updated":"2019-03-09 10:16:52"},{"match_id":"1520784","competition_id":"2156","season_id":"20345","round_id":"27674","date":"2019-03-02","time":"05:00:00","date_utc":"2019-03-02","time_utc":"04:00:00","team_a_id":"36640","team_a_name":"Australia","team_a_short_name":"Australia","team_a_tla_name":"AUS","team_a_original_name":"Australia","team_a_country":"AUS","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36640.png","team_b_id":"36642","team_b_name":"Spain","team_b_short_name":"Spain","team_b_tla_name":"ESP","team_b_original_name":"Spain","team_b_country":"ESP","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/36642.png","status":"Played","gameweek":"","winner":"team_A","score_a":"2","score_b":"1","p1s_a":"0","p1s_b":"0","p2s_a":"1","p2s_b":"1","et_a":"","et_b":"","pen_a":"","pen_b":"","venue_type":"home_away","final_period":"fhk_p4s","attendance":"","venue_id":"13894","venue_name":"Sydney Olympic Park Hockey Centre","venue_city":"Sydney, NSW","last_updated":"2019-03-09 10:36:46"}]}}}}