GET schedules

Description

Returns a list of all scheduled games.

Resource URL

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

Parameters

Field Default Description

start_date

required
Specifies the beginning of the time period for which games should be returned. Format: YYYY-MM-DD

end_date

required
Specifies the end of the time period for which games should be returned Format: YYYY-MM-DD

visiting_team

optional
Limit results to games where a specfic team is the visiting team.

home_team

optional
Limit results to games where a specfic team is the home team.

time_of_day

optional
Limit results to games scheduled for a particular time of day. Options are 'a' (morning), 'd' (day), 'e' (evening/twinight), or 'n' (night). Valid values: a, d, e, n.

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

Return a list of all games that were scheduled for April 15, 2013.

GET

http://clutchwin.com/api/v1/schedules.json?start_date=2013-04-15&end_date=2013-04-15&access_token=[token]

Response:

[
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "ANA",
    "visiting_team_league": "AL",
    "visiting_team_game_number": 13,
    "home_team": "MIN",
    "home_team_league": "AL",
    "home_team_game_number": 13,
    "time_of_day": "n"
  },
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "CHA",
    "visiting_team_league": "AL",
    "visiting_team_game_number": 13,
    "home_team": "TOR",
    "home_team_league": "AL",
    "home_team_game_number": 13,
    "time_of_day": "n"
  },
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "HOU",
    "visiting_team_league": "AL",
    "visiting_team_game_number": 13,
    "home_team": "OAK",
    "home_team_league": "AL",
    "home_team_game_number": 14,
    "time_of_day": "n"
  },
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "NYN",
    "visiting_team_league": "NL",
    "visiting_team_game_number": 13,
    "home_team": "COL",
    "home_team_league": "NL",
    "home_team_game_number": 13,
    "time_of_day": "n"
  },
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "PHI",
    "visiting_team_league": "NL",
    "visiting_team_game_number": 13,
    "home_team": "CIN",
    "home_team_league": "NL",
    "home_team_game_number": 13,
    "time_of_day": "n"
  },
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "SDN",
    "visiting_team_league": "NL",
    "visiting_team_game_number": 13,
    "home_team": "LAN",
    "home_team_league": "NL",
    "home_team_game_number": 13,
    "time_of_day": "n"
  },
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "SLN",
    "visiting_team_league": "NL",
    "visiting_team_game_number": 13,
    "home_team": "PIT",
    "home_team_league": "NL",
    "home_team_game_number": 13,
    "time_of_day": "n"
  },
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "TBA",
    "visiting_team_league": "AL",
    "visiting_team_game_number": 13,
    "home_team": "BOS",
    "home_team_league": "AL",
    "home_team_game_number": 13,
    "time_of_day": "n"
  },
  {
    "game_date": "2013-04-15",
    "game_number": 0,
    "visiting_team": "WAS",
    "visiting_team_league": "NL",
    "visiting_team_game_number": 13,
    "home_team": "MIA",
    "home_team_league": "NL",
    "home_team_game_number": 13,
    "time_of_day": "n"
  }
]
              

Resource Information

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