GET franchises

Description

Returns a list of all franchises.

Resource URL

http://clutchwin.com/api/v1/franchises.json

Parameters

Field Default Description

league

optional
Filters the franchise list for a particular league. Valid values: nl, al.

division

optional
Filters the franchise list for a particular division. Valid values: e, w, c.

max_entries

optional
100 Number of entries to return per request.

start_index

optional
1 The index of the first entry to be returned (used for paging).

Example Requests

Show all franchises from the American League East.

GET

http://clutchwin.com/api/v1/franchises.json?league=al&division=e&access_token=[token]

Response:

[
  {
    "franchise_abbr": "BAL",
    "league": "AL",
    "division": "E",
    "location": "Baltimore",
    "name": "Orioles",
    "alternate_name": null,
    "first_game_dt": "1969-04-08",
    "last_game_dt": null,
    "city": "Baltimore",
    "state": "MD",
    "mlb_abbr": "BAL",
    "park_code": "BAL12"
  },
  {
    "franchise_abbr": "BOS",
    "league": "AL",
    "division": "E",
    "location": "Boston",
    "name": "Red Sox",
    "alternate_name": null,
    "first_game_dt": "1969-04-08",
    "last_game_dt": null,
    "city": "Boston",
    "state": "MA",
    "mlb_abbr": "BOS",
    "park_code": "BOS07"
  },
  {
    "franchise_abbr": "NYA",
    "league": "AL",
    "division": "E",
    "location": "New York",
    "name": "Yankees",
    "alternate_name": null,
    "first_game_dt": "1969-04-07",
    "last_game_dt": null,
    "city": "New York",
    "state": "NY",
    "mlb_abbr": "NYY",
    "park_code": "NYC21"
  },
  {
    "franchise_abbr": "TBA",
    "league": "AL",
    "division": "E",
    "location": "Tampa Bay",
    "name": "Rays",
    "alternate_name": null,
    "first_game_dt": "2008-03-31",
    "last_game_dt": null,
    "city": "St. Petersburg",
    "state": "FL",
    "mlb_abbr": "TB",
    "park_code": "STP01"
  },
  {
    "franchise_abbr": "TOR",
    "league": "AL",
    "division": "E",
    "location": "Toronto",
    "name": "Blue Jays",
    "alternate_name": null,
    "first_game_dt": "1977-04-07",
    "last_game_dt": null,
    "city": "Toronto",
    "state": "ON",
    "mlb_abbr": "TOR",
    "park_code": "TOR02"
  }
]
              

Resource Information

Rate Limited? No
Requests per rate limit window N/A
Response Formats json, xml
HTTP Methods GET
Resource family franchises
API Version API v1.0