No Subscription to this function
GET /american_football/get_team
Returns a list of team details selected from team or season
Request URL
https://dsg-api.com/clients/{client_name}/american_football/get_team?team={team_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)
team
int Required
team id to get details from
Nodes
match
Details about next matches of the particular team
attendance
amount of people that attended the particular match
competition_id
unique identifier for a competition.
competition_name
name of the competition.
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. ('soc_p2s','soc_ets','soc_pen')
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.
ot_a
extra-time score of home team.
ot_b
extra-time score of away team.
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')
method
details about the API function
method_id
unique ID of method.
name
name of method.
related_team
Details about related teams
order
can be used to order the related teams (ascending)
team_id
unique team ID for the team
team_name
current name of the team.
type
type of relation to the main team (reserve, youth, women, related)
team
Basic details about a team
area_id
Unique identifier for area.
area_name
name of area the team is located
gender
gender of the team ('male', 'male youth', 'female' or 'female youth')
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
short_name
short name of the team.
status
The current status of the team ('active' or 'defunct')
team_id
unique team ID for the team.
team_name
current name of the team.
tla_name
three letter acronym for this team
type
Determines the type of team ('national' or 'club')
team_extra
Extra details about a team
adress
Name of street and street number
adress_city
Name of the city
adress_zip
ZIP code
club_colors
Original colors of club (seperated with / )
email
Official e-mail address.
fax
Fax number
founded
Year club was founded. Format 'yyyy'
nicknames
nickname of the club. Can contain until 3 different ones seperated with a "/"
official_name
The official name of a team
primary_venue_id
venue_id of the home venue or primary used one for the particular team
primary_venue_name
venue name of the home venue or primary used one for the particular team
team_logo
full path URL of team logo
tel
Telephone number
website
Official website address (URL).
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}/american_football/get_team?team={team_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}/american_football/get_team?team={team_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/american_football/get_team?team={team_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"american_football","lang":"en","method":{"method_id":"188","name":"get_team"},"team":{"team_id":"1","team_name":"New York Jets","short_name":"Jets","tla_name":"NYJ","type":"club","gender":"male","status":"active","area_id":"203","area_name":"United States","last_updated":"2017-09-04 20:02:48","team_extra":{"adress":"1 Jets Drive","adress_zip":"07932","adress_city":"Florham Park, NJ","tel":"+1 (800) 4695387","fax":"+1 (973) 5494610","website":"http:\/\/www.newyorkjets.com","email":"","official_name":"New York Jets","founded":"1959","club_colors":"Green \/ White","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","nicknames":"Jets \/ Gang Green","primary_venue_id":"","primary_venue_name":""},"team_social_media":{"facebook":"https:\/\/www.facebook.com\/Jets","twitter":"https:\/\/twitter.com\/#!\/nyjets","youtube":"http:\/\/www.youtube.com\/channel\/UCROj9vBjc4ZW3AL4cd_BjHg","google_plus":"","instagram":"http:\/\/instagram.com\/nyjets","vk":""},"last_matches":{"match":[{"match_id":"1321218","date":"2018-11-25","time":"19:00:00","date_utc":"2018-11-25","time_utc":"18:00:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","team_b_id":"2","team_b_name":"New England Patriots","team_b_short_name":"Patriots","team_b_tla_name":"NE","team_b_original_name":"New England Patriots","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/2.png","status":"Played","gameweek":"12","winner":"team_B","score_a":"13","score_b":"27","p1s_a":"7","p1s_b":"7","p2s_a":"3","p2s_b":"3","p3s_a":"3","p3s_b":"10","p4s_a":"0","p4s_b":"7","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"77982","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","competition_id":"1","competition_name":"NFL","season_id":"15914","round_id":"21521","last_updated":"2018-11-26 08:14:14"},{"match_id":"1321240","date":"2018-12-02","time":"22:05:00","date_utc":"2018-12-02","time_utc":"21:05:00","team_a_id":"10","team_a_name":"Tennessee Titans","team_a_short_name":"Titans","team_a_tla_name":"TEN","team_a_original_name":"Tennessee Titans","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/10.png","team_b_id":"1","team_b_name":"New York Jets","team_b_short_name":"Jets","team_b_tla_name":"NYJ","team_b_original_name":"New York Jets","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","status":"Played","gameweek":"13","winner":"team_A","score_a":"26","score_b":"22","p1s_a":"0","p1s_b":"10","p2s_a":"6","p2s_b":"6","p3s_a":"7","p3s_b":"6","p4s_a":"13","p4s_b":"0","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"60904","venue_id":"2311","venue_name":"Nissan Stadium","venue_city":"Nashville, TN","competition_id":"1","competition_name":"NFL","season_id":"15914","round_id":"21521","last_updated":"2018-12-03 16:23:15"},{"match_id":"1321246","date":"2018-12-09","time":"19:00:00","date_utc":"2018-12-09","time_utc":"18:00:00","team_a_id":"4","team_a_name":"Buffalo Bills","team_a_short_name":"Bills","team_a_tla_name":"BUF","team_a_original_name":"Buffalo Bills","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/4.png","team_b_id":"1","team_b_name":"New York Jets","team_b_short_name":"Jets","team_b_tla_name":"NYJ","team_b_original_name":"New York Jets","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","status":"Played","gameweek":"14","winner":"team_B","score_a":"23","score_b":"27","p1s_a":"14","p1s_b":"3","p2s_a":"3","p2s_b":"10","p3s_a":"3","p3s_b":"0","p4s_a":"3","p4s_b":"14","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"59119","venue_id":"11729","venue_name":"New Era Field","venue_city":"Orchard Park, NY","competition_id":"1","competition_name":"NFL","season_id":"15914","round_id":"21521","last_updated":"2018-12-10 08:56:09"},{"match_id":"1321262","date":"2018-12-15","time":"22:30:00","date_utc":"2018-12-15","time_utc":"21:30:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","team_b_id":"9","team_b_name":"Houston Texans","team_b_short_name":"Texans","team_b_tla_name":"HOU","team_b_original_name":"Houston Texans","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/9.png","status":"Played","gameweek":"15","winner":"team_B","score_a":"22","score_b":"29","p1s_a":"3","p1s_b":"3","p2s_a":"6","p2s_b":"13","p3s_a":"6","p3s_b":"0","p4s_a":"7","p4s_b":"13","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"77982","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","competition_id":"1","competition_name":"NFL","season_id":"15914","round_id":"21521","last_updated":"2018-12-16 11:00:23"},{"match_id":"1321279","date":"2018-12-23","time":"19:00:00","date_utc":"2018-12-23","time_utc":"18:00:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","team_b_id":"22","team_b_name":"Green Bay Packers","team_b_short_name":"Packers","team_b_tla_name":"GB","team_b_original_name":"Green Bay Packers","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/22.png","status":"Played","gameweek":"16","winner":"team_B","score_a":"38","score_b":"44","p1s_a":"7","p1s_b":"0","p2s_a":"14","p2s_b":"17","p3s_a":"14","p3s_b":"3","p4s_a":"3","p4s_b":"18","ot_a":"0","ot_b":"6","venue_type":"home_away","final_period":"amf_ets","attendance":"77982","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","competition_id":"1","competition_name":"NFL","season_id":"15914","round_id":"21521","last_updated":"2019-06-12 14:57:55"},{"match_id":"1321298","date":"2018-12-30","time":"19:00:00","date_utc":"2018-12-30","time_utc":"18:00:00","team_a_id":"2","team_a_name":"New England Patriots","team_a_short_name":"Patriots","team_a_tla_name":"NE","team_a_original_name":"New England Patriots","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/2.png","team_b_id":"1","team_b_name":"New York Jets","team_b_short_name":"Jets","team_b_tla_name":"NYJ","team_b_original_name":"New York Jets","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","status":"Played","gameweek":"17","winner":"team_A","score_a":"38","score_b":"3","p1s_a":"7","p1s_b":"3","p2s_a":"14","p2s_b":"0","p3s_a":"7","p3s_b":"0","p4s_a":"10","p4s_b":"0","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"65878","venue_id":"98","venue_name":"Gillette Stadium","venue_city":"Foxborough, MA","competition_id":"1","competition_name":"NFL","season_id":"15914","round_id":"21521","last_updated":"2018-12-31 11:25:44"}]},"next_matches":{"match":[{"match_id":"1627340","date":"2019-09-08","time":"19:00:00","date_utc":"2019-09-08","time_utc":"17:00:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","team_b_id":"4","team_b_name":"Buffalo Bills","team_b_short_name":"Bills","team_b_tla_name":"BUF","team_b_original_name":"Buffalo Bills","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/4.png","status":"Fixture","gameweek":"1","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","p3s_a":"","p3s_b":"","p4s_a":"","p4s_b":"","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","competition_id":"1","competition_name":"NFL","season_id":"21349","round_id":"31371","last_updated":"2019-06-12 14:36:55"},{"match_id":"1627368","date":"2019-09-17","time":"02:15:00","date_utc":"2019-09-17","time_utc":"00:15:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","team_b_id":"8","team_b_name":"Cleveland Browns","team_b_short_name":"Browns","team_b_tla_name":"CLE","team_b_original_name":"Cleveland Browns","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/8.png","status":"Fixture","gameweek":"2","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","p3s_a":"","p3s_b":"","p4s_a":"","p4s_b":"","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","competition_id":"1","competition_name":"NFL","season_id":"21349","round_id":"31371","last_updated":"2019-06-12 14:36:55"},{"match_id":"1627372","date":"2019-09-22","time":"19:00:00","date_utc":"2019-09-22","time_utc":"17:00:00","team_a_id":"2","team_a_name":"New England Patriots","team_a_short_name":"Patriots","team_a_tla_name":"NE","team_a_original_name":"New England Patriots","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/2.png","team_b_id":"1","team_b_name":"New York Jets","team_b_short_name":"Jets","team_b_tla_name":"NYJ","team_b_original_name":"New York Jets","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","status":"Fixture","gameweek":"3","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","p3s_a":"","p3s_b":"","p4s_a":"","p4s_b":"","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"","venue_id":"98","venue_name":"Gillette Stadium","venue_city":"Foxborough, MA","competition_id":"1","competition_name":"NFL","season_id":"21349","round_id":"31371","last_updated":"2019-06-12 14:36:55"},{"match_id":"1627409","date":"2019-10-06","time":"19:00:00","date_utc":"2019-10-06","time_utc":"17:00:00","team_a_id":"17","team_a_name":"Philadelphia Eagles","team_a_short_name":"Eagles","team_a_tla_name":"PHI","team_a_original_name":"Philadelphia Eagles","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/17.png","team_b_id":"1","team_b_name":"New York Jets","team_b_short_name":"Jets","team_b_tla_name":"NYJ","team_b_original_name":"New York Jets","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","status":"Fixture","gameweek":"5","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","p3s_a":"","p3s_b":"","p4s_a":"","p4s_b":"","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"","venue_id":"2436","venue_name":"Lincoln Financial Field","venue_city":"Philadelphia, PA","competition_id":"1","competition_name":"NFL","season_id":"21349","round_id":"31371","last_updated":"2019-06-12 14:36:55"},{"match_id":"1627425","date":"2019-10-13","time":"22:25:00","date_utc":"2019-10-13","time_utc":"20:25:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","team_b_id":"20","team_b_name":"Dallas Cowboys","team_b_short_name":"Cowboys","team_b_tla_name":"DAL","team_b_original_name":"Dallas Cowboys","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/20.png","status":"Fixture","gameweek":"6","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","p3s_a":"","p3s_b":"","p4s_a":"","p4s_b":"","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","competition_id":"1","competition_name":"NFL","season_id":"21349","round_id":"31371","last_updated":"2019-06-12 14:36:55"},{"match_id":"1627442","date":"2019-10-22","time":"02:15:00","date_utc":"2019-10-22","time_utc":"00:15:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/1.png","team_b_id":"2","team_b_name":"New England Patriots","team_b_short_name":"Patriots","team_b_tla_name":"NE","team_b_original_name":"New England Patriots","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/2.png","status":"Fixture","gameweek":"7","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","p3s_a":"","p3s_b":"","p4s_a":"","p4s_b":"","ot_a":"","ot_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","competition_id":"1","competition_name":"NFL","season_id":"21349","round_id":"31371","last_updated":"2019-06-12 14:36:55"}]}}}}