Last updated February 12, 2016
This endpoint returns information including teams, dates, rounds, and seeds for a sport's tournament aka playoffs.
GET /sport/tournament.format
Required. A valid access token must be included in the header of the request.
| Name | Required | Description |
|---|---|---|
season |
optional | Return response for specified tournament using yyyy format. If omitted, defaults to current or most recent tournament. |
| Name | Type | Description |
|---|---|---|
sport |
string | Sport abbreviation |
season |
string | The season |
name |
string | The name of this tournament |
seeded |
boolean | True or false value indicates if teams are seeded |
groups_total |
integer | The number of groups (i.e., conferences, divisions, pools, regions) competing |
rounds_total |
integer | The number of distinct rounds (i.e., first, second, quarterfinals, semifinals) in this tournament |
competitors_total |
integer | The number of competitors in this tournament |
start_date |
date | The date in YYYY-MM-DD format when this tournament starts |
finish_date |
date | The date in YYYY-MM-DD format when this tournament finishes |
rounds |
array of objects | Array of Round objects that contain details for each round |
groups |
array of objects | Array of Group objects that contain the name of each group and the Competitor contained within the group |
curl -H "Authorization: Bearer ACCESS_TOKEN" "https://erikberg.com/mlb/tournament.json?season=2014"
{
"sport" : "MLB",
"season" : "2015",
"season_type" : "post",
"name" : "2015 MLB Postseason",
"description" : "The competition to determine the 2015 MLB champion.",
"seeded" : true,
"groups_total" : 2,
"competitors_total" : 10,
"rounds_total" : 4,
"start_date" : "2015-10-05",
"finish_date" : "2015-11-10",
"rounds" : [ {
"sequence" : 1,
"name" : "Wildcard",
"start_date" : "2015-10-06",
"finish_date" : "2015-10-07",
"round_format" : "Single Elimination"
}, {
"sequence" : 2,
"name" : "Division Series",
"start_date" : "2015-10-08",
"finish_date" : "2015-10-15",
"round_format" : "Best of Five"
}, {
"sequence" : 3,
"name" : "League Championship Series",
"start_date" : "2015-10-16",
"finish_date" : "2015-10-25",
"round_format" : "Best of Seven"
}, {
"sequence" : 4,
"name" : "World Series",
"start_date" : "2015-10-27",
"finish_date" : "2015-11-04",
"round_format" : "Best of Seven"
} ],
"groups" : [ {
"name" : "American League",
"description" : "The teams representing the American League",
"competitors_total" : 5,
"competitors" : [ {
"seed" : 1,
"team" : {
"team_id" : "kansas-city-royals",
"abbreviation" : "KC",
"active" : true,
"first_name" : "Kansas City",
"last_name" : "Royals",
"conference" : "American",
"division" : "Central",
"site_name" : "Kauffman Stadium",
"city" : "Kansas City",
"state" : "Missouri",
"full_name" : "Kansas City Royals"
}
}, {
"seed" : 2,
"team" : {
"team_id" : "toronto-blue-jays",
"abbreviation" : "TOR",
"active" : true,
"first_name" : "Toronto",
"last_name" : "Blue Jays",
"conference" : "American",
"division" : "East",
"site_name" : "Rogers Centre",
"city" : "Toronto",
"state" : "Ontario",
"full_name" : "Toronto Blue Jays"
}
}, {
"seed" : 3,
"team" : {
"team_id" : "texas-rangers",
"abbreviation" : "TEX",
"active" : true,
"first_name" : "Texas",
"last_name" : "Rangers",
"conference" : "American",
"division" : "West",
"site_name" : "Globe Life Park in Arlington",
"city" : "Arlington",
"state" : "Texas",
"full_name" : "Texas Rangers"
}
}, {
"seed" : 4,
"team" : {
"team_id" : "houston-astros",
"abbreviation" : "HOU",
"active" : true,
"first_name" : "Houston",
"last_name" : "Astros",
"conference" : "American",
"division" : "West",
"site_name" : "Minute Maid Park",
"city" : "Houston",
"state" : "Texas",
"full_name" : "Houston Astros"
}
}, {
"seed" : 5,
"team" : {
"team_id" : "new-york-yankees",
"abbreviation" : "NYY",
"active" : true,
"first_name" : "New York",
"last_name" : "Yankees",
"conference" : "American",
"division" : "East",
"site_name" : "Yankee Stadium",
"city" : "Bronx",
"state" : "New York",
"full_name" : "New York Yankees"
}
} ]
}, {
"name" : "National League",
"description" : "The teams representing the National League.",
"competitors_total" : 5,
"competitors" : [ {
"seed" : 1,
"team" : {
"team_id" : "st-louis-cardinals",
"abbreviation" : "STL",
"active" : true,
"first_name" : "St. Louis",
"last_name" : "Cardinals",
"conference" : "National",
"division" : "Central",
"site_name" : "Busch Stadium",
"city" : "Saint Louis",
"state" : "Missouri",
"full_name" : "St. Louis Cardinals"
}
}, {
"seed" : 2,
"team" : {
"team_id" : "los-angeles-angels",
"abbreviation" : "LAA",
"active" : true,
"first_name" : "Los Angeles",
"last_name" : "Angels",
"conference" : "American",
"division" : "West",
"site_name" : "Angel Stadium of Anaheim",
"city" : "Anaheim",
"state" : "California",
"full_name" : "Los Angeles Angels"
}
}, {
"seed" : 3,
"team" : {
"team_id" : "new-york-mets",
"abbreviation" : "NYM",
"active" : true,
"first_name" : "New York",
"last_name" : "Mets",
"conference" : "National",
"division" : "East",
"site_name" : "Citi Field",
"city" : "Flushing",
"state" : "New York",
"full_name" : "New York Mets"
}
}, {
"seed" : 4,
"team" : {
"team_id" : "pittsburgh-pirates",
"abbreviation" : "PIT",
"active" : true,
"first_name" : "Pittsburgh",
"last_name" : "Pirates",
"conference" : "National",
"division" : "Central",
"site_name" : "PNC Park",
"city" : "Pittsburgh",
"state" : "Pennsylvania",
"full_name" : "Pittsburgh Pirates"
}
}, {
"seed" : 5,
"team" : {
"team_id" : "chicago-cubs",
"abbreviation" : "CHC",
"active" : true,
"first_name" : "Chicago",
"last_name" : "Cubs",
"conference" : "National",
"division" : "Central",
"site_name" : "Wrigley Field",
"city" : "Chicago",
"state" : "Illinois",
"full_name" : "Chicago Cubs"
}
} ]
} ]
}