No Subscription to this function
GET /american_football/get_season_venue
Returns list of all venues for a particular season
Request URL
https://dsg-api.com/clients/{client_name}/american_football/get_season_venue?id={season_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
unique season_id
lang
string
two-character language code, defaults to 'en'
Nodes
venue
Details about venue
adress
Name of street and street number
adress_zip
ZIP code
area
name of area the venue is located
capacity
Contains the maximum capacity of the venue.
city
Name of the city where venue is located
geo_latitude
Latitude coordinates of venue
geo_longtitude
Longitude coordinates of venue
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
Current name of the venue
nicknames
nicknames of the venue. If more as 1 then seperated with a ","
opened
Year venue was opened. Format 'yyyy'
status
The current status of the venue ('open' or 'demolished')
surface
Determines the surface of venue.
venue_id
Unique identifier of the venue
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}/american_football/get_season_venue?id={season_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_season_venue?id={season_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/american_football/get_season_venue?id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"american_football","lang":"en","method":{"method_id":"342","name":"get_season_venue"},"venue":[{"venue_id":"4","name":"Dignity Health Sports Park","city":"Carson, CA","area":"United States","area_id":"203","adress":"18400 Avalon Boulevard, Dominguez Hills","adress_zip":"90746","oepened":"2003","status":"open","nicknames":"The Home Depot Center, HDC Stadium, StubHub Center Track & Field Stadium","geo_latitude":"33.864335519093366","geo_longtitude":"-118.26107919216156","capacity":"27000","surface":"grass","last_updated":"2019-03-11 19:28:57"},{"venue_id":"9","name":"Levi's Stadium","city":"Santa Clara, CA","area":"United States","area_id":"203","adress":"4900 Marie P DeBartolo Boulevard","adress_zip":"","oepened":"2014","status":"open","nicknames":"The Field of Jeans","geo_latitude":"37.40322778728967","geo_longtitude":"-121.96977646895601","capacity":"68500","surface":"grass","last_updated":"2016-07-01 17:23:01"},{"venue_id":"10","name":"FedEx Field","city":"Landover, MD","area":"United States","area_id":"203","adress":"1600 FedEx Way","adress_zip":"20785","oepened":"1997","status":"open","nicknames":"Jack Kent Cooke Stadium","geo_latitude":"38.90768425263718","geo_longtitude":"-76.86450898647308","capacity":"91704","surface":"artificial turf","last_updated":"2016-07-01 17:23:01"},{"venue_id":"98","name":"Gillette Stadium","city":"Foxborough, MA","area":"United States","area_id":"203","adress":"1388 One Patriot Place","adress_zip":"02035","oepened":"2002","status":"open","nicknames":"The Razor","geo_latitude":"42.0912961715144","geo_longtitude":"-71.26404583454132","capacity":"68756","surface":"artificial turf","last_updated":"2016-07-01 17:23:01"},{"venue_id":"105","name":"CenturyLink Field","city":"Seattle, WA","area":"United States","area_id":"203","adress":"800 Occidental Avenue South","adress_zip":"98134","oepened":"2002","status":"open","nicknames":"The Hawk, Hawks Nest, Seahawks Stadium, Qwest Field","geo_latitude":"47.59516315685348","geo_longtitude":"-122.33163177967072","capacity":"67385","surface":"artificial turf","last_updated":"2016-07-01 17:23:01"},{"venue_id":"359","name":"Wembley Stadium","city":"London","area":"England","area_id":"68","adress":"Stadium Way, Wembley, Brent","adress_zip":"HA9 0WS","oepened":"2007","status":"open","nicknames":"","geo_latitude":"51.555855088657374","geo_longtitude":"-0.27959346771240234","capacity":"90000","surface":"grass","last_updated":"2016-07-01 17:23:01"},{"venue_id":"862","name":"Estadio Azteca","city":"Coyoacán","area":"Mexico","area_id":"129","adress":"Calzada de Tlalpan 3665","adress_zip":"4650","oepened":"1966","status":"open","nicknames":"Coloso de Santa Úrsula, Estadio Guillermo Cañedo","geo_latitude":"19.302825295148843","geo_longtitude":"-99.15038824081421","capacity":"87523","surface":"grass","last_updated":"2016-07-01 17:23:01"},{"venue_id":"886","name":"Los Angeles Memorial Coliseum","city":"Los Angeles, CA","area":"United States","area_id":"203","adress":"3911 South Figueroa Street","adress_zip":"90037","oepened":"1923","status":"open","nicknames":"The Grand Old Lady","geo_latitude":"34.01401418719947","geo_longtitude":"-118.28800857067108","capacity":"77500","surface":"grass","last_updated":"2017-07-10 00:59:11"},{"venue_id":"1962","name":"Soldier Field","city":"Chicago, IL","area":"United States","area_id":"203","adress":"1410 South Museum Campus Drive","adress_zip":"60605","oepened":"1924","status":"open","nicknames":"Municipal Grant Park Stadium","geo_latitude":"41.862310033544205","geo_longtitude":"-87.61667490005493","capacity":"61500","surface":"grass","last_updated":"2016-07-01 17:23:01"},{"venue_id":"1963","name":"State Farm Stadium","city":"Glendale, AZ","area":"United States","area_id":"203","adress":"1 Cardinals Drive","adress_zip":"85305","oepened":"2006","status":"open","nicknames":"University of Phoenix Stadium","geo_latitude":"33.527626834495216","geo_longtitude":"-112.26252257823944","capacity":"63400","surface":"grass","last_updated":"2019-06-12 14:41:25"},{"venue_id":"1964","name":"Bank of America Stadium","city":"Charlotte, NC","area":"United States","area_id":"203","adress":"800 South Mint Street","adress_zip":"28202","oepened":"1996","status":"open","nicknames":"","geo_latitude":"35.22582312444026","geo_longtitude":"-80.8528733253479","capacity":"73778","surface":"grass","last_updated":"2017-07-10 17:14:06"},{"venue_id":"1999","name":"MetLife Stadium","city":"East Rutherford, NJ","area":"United States","area_id":"203","adress":"1 MetLife Stadium Drive","adress_zip":"07073","oepened":"2010","status":"open","nicknames":"The Meadowlands, New Meadowlands Stadium","geo_latitude":"40.81355345051812","geo_longtitude":"-74.07436788082123","capacity":"82500","surface":"artificial turf","last_updated":"2018-04-18 11:31:59"},{"venue_id":"2000","name":"Arrowhead Stadium","city":"Kansas City, MO","area":"United States","area_id":"203","adress":"1 Arrowhead Drive","adress_zip":"64129","oepened":"1972","status":"open","nicknames":"The Sea of Red, Truman Sports Complex","geo_latitude":"39.048931391072365","geo_longtitude":"-94.48399364948273","capacity":"79416","surface":"artificial turf","last_updated":"2016-07-01 17:23:01"},{"venue_id":"2142","name":"TIAA Bank Field","city":"Jacksonville, FL","area":"United States","area_id":"203","adress":"1 EverBank Field Drive","adress_zip":"32202","oepened":"1995","status":"open","nicknames":"Jacksonville Municipal Stadium, Alltel Stadium","geo_latitude":"30.323910798388802","geo_longtitude":"-81.63732826709747","capacity":"69132","surface":"grass","last_updated":"2018-08-01 13:13:31"},{"venue_id":"2310","name":"NRG Stadium","city":"Houston, TX","area":"United States","area_id":"203","adress":"One Reliant Park","adress_zip":"77054","oepened":"2002","status":"open","nicknames":"Reliant Stadium","geo_latitude":"29.6848278005025","geo_longtitude":"-95.41093826293945","capacity":"71795","surface":"artificial turf","last_updated":"2016-07-01 17:23:01"},{"venue_id":"2311","name":"Nissan Stadium","city":"Nashville, TN","area":"United States","area_id":"203","adress":"1 Titans Way","adress_zip":"37213","oepened":"1999","status":"open","nicknames":"Adelphia Coliseum, The Coliseum, LP Field","geo_latitude":"36.166488706698225","geo_longtitude":"-86.77128553390503","capacity":"69143","surface":"grass","last_updated":"2017-03-07 22:58:08"},{"venue_id":"2418","name":"M&T Bank Stadium","city":"Baltimore, MD","area":"United States","area_id":"203","adress":"1101 Russell Street","adress_zip":"21230","oepened":"1998","status":"open","nicknames":"Russell Street Coliseum, The Bank, The Purple Palace, The Big Crab Cake, The Nest, Ravens Stadium at Camden Yards, PSINet Stadium, Ravens Stadium","geo_latitude":"39.27798716541208","geo_longtitude":"-76.62271857261658","capacity":"71008","surface":"grass","last_updated":"2017-07-09 19:10:01"},{"venue_id":"2436","name":"Lincoln Financial Field","city":"Philadelphia, PA","area":"United States","area_id":"203","adress":"1020 Pattison Avenue","adress_zip":"19148","oepened":"2003","status":"open","nicknames":"The Linc","geo_latitude":"39.900833","geo_longtitude":"-75.1675","capacity":"69176","surface":"grass","last_updated":"2018-04-18 11:24:30"},{"venue_id":"2547","name":"AT&T Stadium","city":"Arlington, TX","area":"United States","area_id":"203","adress":"1 AT&T Way","adress_zip":"76001","oepened":"2009","status":"open","nicknames":"Cowboys Stadium","geo_latitude":"32.747778","geo_longtitude":"-97.092778","capacity":"105121","surface":"artificial turf","last_updated":"2017-07-09 19:12:06"},{"venue_id":"5679","name":"Broncos Stadium at Mile High","city":"Denver, CO","area":"United States","area_id":"203","adress":"1701 Mile High Stadium Circle West","adress_zip":"80204","oepened":"2001","status":"open","nicknames":"Invesco Field at Mile High, Mile High Stadium","geo_latitude":"39.743935616697655","geo_longtitude":"-105.02007275819778","capacity":"76125","surface":"grass","last_updated":"2018-08-01 13:12:54"},{"venue_id":"6720","name":"Oakland–Alameda County Coliseum","city":"Oakland, CA","area":"United States","area_id":"203","adress":"7000 Coliseum Way","adress_zip":"94621","oepened":"1966","status":"open","nicknames":"Oakland Coliseum, The Coliseum, Network Associates Coliseum, McAfee Coliseum","geo_latitude":"37.751549880119384","geo_longtitude":"-122.20073461532593","capacity":"63132","surface":"grass","last_updated":"2018-04-05 14:30:12"},{"venue_id":"6725","name":"Ford Field","city":"Detroit, MI","area":"United States","area_id":"203","adress":"2000 Brush Street","adress_zip":"48226","oepened":"2002","status":"open","nicknames":"","geo_latitude":"42.340013453186586","geo_longtitude":"-83.04564356803894","capacity":"65000","surface":"artificial turf","last_updated":"2016-11-21 20:00:21"},{"venue_id":"6726","name":"Raymond James Stadium","city":"Tampa, FL","area":"United States","area_id":"203","adress":"4201 North Dale Mabry Highway","adress_zip":"33607","oepened":"1998","status":"open","nicknames":"Ray Jay, The New Sombrero","geo_latitude":"27.97597863170003","geo_longtitude":"-82.50329554080963","capacity":"65890","surface":"grass","last_updated":"2016-11-21 20:01:05"},{"venue_id":"6727","name":"Hard Rock Stadium","city":"Miami Gardens, FL","area":"United States","area_id":"203","adress":"2269 Dan Marino Boulevard","adress_zip":"33169","oepened":"1987","status":"open","nicknames":"Sun Life Stadium, New Miami Stadium","geo_latitude":"25.95791926933141","geo_longtitude":"-80.23884057998657","capacity":"74916","surface":"grass","last_updated":"2016-11-21 20:02:06"},{"venue_id":"7875","name":"FirstEnergy Stadium","city":"Cleveland, OH","area":"United States","area_id":"203","adress":"100 Alfred Lerner Way","adress_zip":"","oepened":"1999","status":"open","nicknames":"Cleveland Browns Stadium","geo_latitude":"41.506111","geo_longtitude":"-81.699444","capacity":"67431","surface":"grass","last_updated":"2018-04-18 11:13:07"},{"venue_id":"9102","name":"Mercedes-Benz Superdome","city":"New Orleans, LA","area":"United States","area_id":"203","adress":"1500 Sugar Bowl Drive","adress_zip":"70112","oepened":"1975","status":"open","nicknames":"Louisiana Superdome, The Superdome","geo_latitude":"29.951023015900095","geo_longtitude":"-90.08117524232783","capacity":"73208","surface":"artificial turf","last_updated":"2018-04-18 11:29:41"},{"venue_id":"9231","name":"Mercedes-Benz Stadium","city":"Atlanta, GA","area":"United States","area_id":"203","adress":"1 AMB Drive North West","adress_zip":"30313","oepened":"2017","status":"open","nicknames":"New Atlanta Stadium","geo_latitude":"33.75540617490541","geo_longtitude":"-84.40107526322936","capacity":"71000","surface":"artificial turf","last_updated":"2017-09-13 20:37:58"},{"venue_id":"11523","name":"Lucas Oil Stadium","city":"Indianapolis, IN","area":"United States","area_id":"203","adress":"500 South Capitol Avenue","adress_zip":"46225","oepened":"2008","status":"open","nicknames":"","geo_latitude":"39.7601048","geo_longtitude":"-86.1660764","capacity":"67000","surface":"artificial turf","last_updated":"2018-03-23 19:00:45"},{"venue_id":"11727","name":"Heinz Field","city":"Pittsburgh, PA","area":"United States","area_id":"203","adress":"100 Art Rooney Avenue","adress_zip":"","oepened":"2001","status":"open","nicknames":"","geo_latitude":"40.446667","geo_longtitude":"-80.015833","capacity":"69690","surface":"grass","last_updated":"2018-04-18 11:18:40"},{"venue_id":"11728","name":"Lambeau Field","city":"Green Bay, WI","area":"United States","area_id":"203","adress":"1265 Lombardi Avenue","adress_zip":"","oepened":"1957","status":"open","nicknames":"The Frozen Tundra","geo_latitude":"44.501389","geo_longtitude":"-88.062222","capacity":"81441","surface":"grass","last_updated":"2018-04-18 11:23:11"},{"venue_id":"11729","name":"New Era Field","city":"Orchard Park, NY","area":"United States","area_id":"203","adress":"1 Bills Drive","adress_zip":"","oepened":"1973","status":"open","nicknames":"The Ralph","geo_latitude":"42.774","geo_longtitude":"-78.787","capacity":"71608","surface":"artificial turf","last_updated":"2018-04-18 11:34:27"},{"venue_id":"11730","name":"Paul Brown Stadium","city":"Cincinnati, OH","area":"United States","area_id":"203","adress":"1 Paul Brown Stadium","adress_zip":"","oepened":"2000","status":"open","nicknames":"The Jungle, PBS","geo_latitude":"39.095","geo_longtitude":"-84.516","capacity":"65515","surface":"artificial turf","last_updated":"2018-04-18 11:39:24"},{"venue_id":"11731","name":"U.S. Bank Stadium","city":"Minneapolis, MN","area":"United States","area_id":"203","adress":"401 Chicago Avenue","adress_zip":"","oepened":"2016","status":"open","nicknames":"The Ship","geo_latitude":"44.974","geo_longtitude":"-93.258","capacity":"66655","surface":"artificial turf","last_updated":"2018-04-18 11:47:33"},{"venue_id":"12730","name":"Tottenham Hotspur Stadium","city":"London","area":"England","area_id":"68","adress":"High Rd, Tottenham","adress_zip":"","oepened":"2018","status":"open","nicknames":"","geo_latitude":"51.60475","geo_longtitude":"-0.066417","capacity":"62062","surface":"artificial turf","last_updated":"2018-08-01 13:31:19"}]}}