No Subscription to this function
GET /american_football/get_rounds
Returns all available rounds for a certain season.
Request URL
https://dsg-api.com/clients/{client_name}/american_football/get_rounds?season_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)
lang
string
two-character language code, defaults to 'en'
season_id
int Required
season to get the rounds from
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).
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}/american_football/get_rounds?season_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_rounds?season_id={season_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/american_football/get_rounds?season_id={season_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":"67","name":"get_rounds"},"competition":{"competition_id":"1","name":"NFL","teamtype":"male","type":"club","format":"domestic_league","area_id":"203","area_name":"United States","last_updated":"2019-01-05 03:12:48","season":{"season_id":"15914","title":"2018\/2019","original_name":"NFL","start_date":"2018-09-06","end_date":"2019-02-04","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1.png","last_updated":"2018-04-20 13:09:48","rounds":[{"round_id":"21521","name":"Regular Season","start_date":"2018-09-06","end_date":"2018-12-31","type":"table","current_gameweek":"17","last_updated":"2018-04-20 13:11:49","group":[{"group_id":"5777","name":"AFC East","last_updated":"2018-04-20 13:12:47"},{"group_id":"5778","name":"AFC North","last_updated":"2018-04-20 13:12:52"},{"group_id":"5779","name":"AFC South","last_updated":"2018-04-20 13:13:25"},{"group_id":"5780","name":"AFC West","last_updated":"2018-04-20 13:13:30"},{"group_id":"5781","name":"NFC East","last_updated":"2018-04-20 13:13:44"},{"group_id":"5782","name":"NFC North","last_updated":"2018-04-20 13:13:53"},{"group_id":"5783","name":"NFC South","last_updated":"2018-04-20 13:14:03"},{"group_id":"5784","name":"NFC West","last_updated":"2018-04-20 13:14:11"}]},{"round_id":"21522","name":"AFC Wild Card","start_date":"2019-01-05","end_date":"2019-01-07","type":"cup","current_gameweek":"","last_updated":"2018-04-20 13:18:36"},{"round_id":"21523","name":"NFC Wild Card","start_date":"2019-01-05","end_date":"2019-01-07","type":"cup","current_gameweek":"","last_updated":"2018-04-20 13:19:03"},{"round_id":"21524","name":"AFC Divisional Play-offs","start_date":"2019-01-12","end_date":"2019-01-14","type":"cup","current_gameweek":"","last_updated":"2018-04-20 13:20:29"},{"round_id":"21525","name":"NFC Divisional Play-offs","start_date":"2019-01-12","end_date":"2019-01-14","type":"cup","current_gameweek":"","last_updated":"2018-04-20 13:20:20"},{"round_id":"21526","name":"NFC Championship","start_date":"2019-01-20","end_date":"2019-01-21","type":"cup","current_gameweek":"","last_updated":"2018-04-20 13:21:59"},{"round_id":"21527","name":"AFC Championship","start_date":"2019-01-20","end_date":"2019-01-21","type":"cup","current_gameweek":"","last_updated":"2018-04-20 13:21:59"},{"round_id":"21528","name":"Super Bowl","start_date":"2019-02-03","end_date":"2019-02-04","type":"cup","current_gameweek":"","last_updated":"2018-04-20 13:22:29"}]}}}}