Each League consists of one or more seasons, and every League is owned by a single organization.
GET
/leagues/
Get a list of leagues
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/leagues/{league_id}/
Get a league
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/leagues/{league_id}/
Update a league
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/leagues/
Create a league
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/leagues/{league_id}/
Delete a league
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Season
Each season takes place over a finite period of time. Two seasons from the same league should theoretically not overlap with one another. For instance, the League "USA Ultimate Club Mixed" has the seasons "2011", "2012", etc.
GET
/seasons/
Get a list of seasons
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/seasons/{season_id}/
Get a season
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/seasons/{season_id}/
Update a season
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/seasons/
Create a season
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/seasons/{season_id}/
Delete a season
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Players
Player
GET
/players/
Get a list of players
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/players/{player_id}/
Get a player
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/players/{player_id}/
Update a player
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/players/
Create a player
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/players/{player_id}/
Delete a player
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Me
Get the player resource for the currently logged in user
GET
/players/me/
Get the logged in player
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Teams
Team
Each team belongs to exactly one season. Teams can be related via the related_teams parameter so the team Machine can belong to seasons 2009, 2010, 2011, etc. with different rosters, results, and stats for each season
GET
/teams/
Get a list of teams
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/teams/{team_id}/
Get a team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/teams/{team_id}/
Update a team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/teams/
Create a team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/teams/{team_id}/
Delete a team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Team Player
Each Team Player object specifies a team that a player plays on along with any information specific to that player's status on the team, such as a player's jersey number.
GET
/team_players/
Get a list of players for a team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/team_players/{team_id}/{player_id}/
Get a team player
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/team_players/{team_id}/{player_id}/
Update a team player
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/team_players/
Add a player to a team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/team_players/{team_id}/{player_id}/
Remove a player from a team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Games
Game
GET
/games/
Get a list of games
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/games/{game_id}/
Get a game
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/games/{game_id}/
Update a game
Games may optionally be part of a tournament. If they are part of a tournament, these games are limited to Pool games, Bracket games, and SwissRound games. To create Bracket games, you must create a new bracket. To create SwissRound games, you must create a new SwissRound. To create Pool games, you may either create a new Pool while auto-generating the games or create individual games using this the Games POST/PUT methods and specifying a pool_round_id for the pool it belongs to.
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/games/
Create a game
Games may optionally be part of a tournament. If they are part of a tournament, these games are limited to Pool games, Bracket games, and SwissRound games. To create Bracket games, you must create a new bracket. To create SwissRound games, you must create a new SwissRound. To create Pool games, you may either create a new Pool while auto-generating the games or create individual games using this the Games POST/PUT methods and specifying a pool_round_id for the pool it belongs to.
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/games/{game_id}/
Delete a game
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Game Score
GET
/game_scores/
Get a list of game scores
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/game_scores/{score_id}/
Get a game score
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/game_scores/
Create a game_score
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/game_scores/{score_id}/
Delete a game_score
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Game Sportsmanship Score
This resource allows you to store arbitrary information about the sportsmanship of a team in a game. Many leagues keep track of the sportsmanship of teams but the formats vary widely between different leagues. Thus, the fields on this resource for storing this score are strings so you may format/encode the necessary information however you want.
GET
/game_sportsmanship_scores/
Get a list of sportsmanship scores
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/game_sportsmanship_scores/{score_id}/
Get a sportsmanship score
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/game_sportsmanship_scores/{score_id}/
Update a sportsmanship score
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/game_sportsmanship_scores/
Create a sportsmanship score
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/game_sportsmanship_scores/{score_id}/
Delete a sportsmanship score
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Tournaments
Tournament
GET
/tournaments/
Get a list of tournaments
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/tournaments/{tournament_id}/
Get a tournament
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/tournaments/{tournament_id}/
Update a tournament
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/tournaments/
Create a tournament
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/tournaments/{tournament_id}/
Delete a tournament
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Tournament Team
Each tournament team object specifies a team that is part of a tournament along with information specific to that team in the tournament such as seeding or final placement
GET
/tournament_teams/
Get a list of tournament teams
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/tournament_teams/{tournament_id}/{team_id}/
Get a tournament team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/tournament_teams/{tournament_id}/{team_id}/
Update a tournament team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/tournament_teams/
Create a tournament team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/tournament_teams/{tournament_id}/{team_id}/
Delete a tournament team
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Pool
GET
/pools/
Get a list of pools
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/pools/{pool_id}/
Get a pool
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/pools/{pool_id}/
Update a pool
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/pools/
Create a pool
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/pools/{pool_id}/
Delete a pool
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Pool Round
Each pool consists of a number of rounds during which games are being played.
GET
/pool_rounds/
Get a pool's rounds
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/pool_rounds/{pool_round_id}/
Get a pool round
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/pool_rounds/{pool_round_id}/
Update a pool round
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/pool_rounds/
Create a pool round
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/pool_rounds/{pool_round_id}/
Delete a pool round
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Bracket
GET
/brackets/
Get a list of brackets
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/brackets/{bracket_id}/
Get a bracket
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/brackets/{bracket_id}/
Update a bracket
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/brackets/
Create a bracket
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/brackets/{bracket_id}/
Delete a bracket
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Swiss Round
GET
/swiss_rounds/
Get a list of swiss rounds
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/swiss_rounds/{swiss_round_id}/
Get a swiss round
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/swiss_rounds/{swiss_round_id}/
Update a swiss round
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/swiss_rounds/
Create a swiss round
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/swiss_rounds/{swiss_round_id}/
Delete a swiss round
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Locations
Event Site
An event site identifies a single location where one or more games can be played. Event sites typically have maps that label the areas of play and any other important things such as bathrooms or parking.
GET
/event_sites/
Get a list of event sites
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/event_sites/{event_site_id}/
Get an event site
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/event_sites/{event_site_id}/
Update an event site
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/event_sites/
Create an event site
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/event_sites/{event_site_id}/
Delete an event site
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Game Site
A game site is a single area of play where a game can be played on. Each game site belongs to a larger event site.
GET
/game_sites/
Get a list of game sites
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/game_sites/{game_site_id}/
Get a game site
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/game_sites/{game_site_id}/
Update a game site
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/game_sites/
Create game site
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/game_sites/{game_site_id}/
Delete a game site
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Events
Event
GET
/events/
Get a list of events
Each of an event's attributes means different things depending on the event type. More information
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
GET
/events/{event_id}/
Get an event
Each of an event's attributes means different things depending on the event type. More information
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
PUT
/events/{event_id}/
Update an event
Each of an event's attributes means different things depending on the event type. More information
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
POST
/events/
Create an event
When creating an event, each of these parameters means different things depending on the event type. More information
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
DELETE
/events/{event_id}/
Delete an event
Request:
Request Headers (partial):
Request Body:
Response Code:
Response Headers:
Response Body:
Player Stats
Player Stats Per Game
GET
/stats/{sport}/player_stats_per_game/
Get player stats for games
Returns a list of individual player stat lines accumulated during one or more games.