REST API Resources

* You must be logged in to try out this API

Leagues

Organization

GET
/organizations/
Get a list of organizations
GET
/organizations/{organization_id}/
Get an organization
PUT
/organizations/{organization_id}/
Update an organization
POST
/organizations/
Create an organization
DELETE
/organizations/{organization_id}/
Delete an organization

League

Each League consists of one or more seasons, and every League is owned by a single organization.
GET
/leagues/
Get a list of leagues
GET
/leagues/{league_id}/
Get a league
PUT
/leagues/{league_id}/
Update a league
POST
/leagues/
Create a league
DELETE
/leagues/{league_id}/
Delete a league

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
GET
/seasons/{season_id}/
Get a season
PUT
/seasons/{season_id}/
Update a season
POST
/seasons/
Create a season
DELETE
/seasons/{season_id}/
Delete a season

Players

Player

GET
/players/
Get a list of players
GET
/players/{player_id}/
Get a player
PUT
/players/{player_id}/
Update a player
POST
/players/
Create a player
DELETE
/players/{player_id}/
Delete a player

Me

Get the player resource for the currently logged in user
GET
/players/me/
Get the logged in player

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
GET
/teams/{team_id}/
Get a team
PUT
/teams/{team_id}/
Update a team
POST
/teams/
Create a team
DELETE
/teams/{team_id}/
Delete a team

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
GET
/team_players/{team_id}/{player_id}/
Get a team player
PUT
/team_players/{team_id}/{player_id}/
Update a team player
POST
/team_players/
Add a player to a team
DELETE
/team_players/{team_id}/{player_id}/
Remove a player from a team

Games

Game

GET
/games/
Get a list of games
GET
/games/{game_id}/
Get a game
PUT
/games/{game_id}/
Update a game
POST
/games/
Create a game
DELETE
/games/{game_id}/
Delete a game

Game Score

GET
/game_scores/
Get a list of game scores
GET
/game_scores/{score_id}/
Get a game score
POST
/game_scores/
Create a game_score
DELETE
/game_scores/{score_id}/
Delete a game_score

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
GET
/game_sportsmanship_scores/{score_id}/
Get a sportsmanship score
PUT
/game_sportsmanship_scores/{score_id}/
Update a sportsmanship score
POST
/game_sportsmanship_scores/
Create a sportsmanship score
DELETE
/game_sportsmanship_scores/{score_id}/
Delete a sportsmanship score

Tournaments

Tournament

GET
/tournaments/
Get a list of tournaments
GET
/tournaments/{tournament_id}/
Get a tournament
PUT
/tournaments/{tournament_id}/
Update a tournament
POST
/tournaments/
Create a tournament
DELETE
/tournaments/{tournament_id}/
Delete a tournament

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
GET
/tournament_teams/{tournament_id}/{team_id}/
Get a tournament team
PUT
/tournament_teams/{tournament_id}/{team_id}/
Update a tournament team
POST
/tournament_teams/
Create a tournament team
DELETE
/tournament_teams/{tournament_id}/{team_id}/
Delete a tournament team

Pool

GET
/pools/
Get a list of pools
GET
/pools/{pool_id}/
Get a pool
PUT
/pools/{pool_id}/
Update a pool
POST
/pools/
Create a pool
DELETE
/pools/{pool_id}/
Delete a pool

Pool Round

Each pool consists of a number of rounds during which games are being played.
GET
/pool_rounds/
Get a pool's rounds
GET
/pool_rounds/{pool_round_id}/
Get a pool round
PUT
/pool_rounds/{pool_round_id}/
Update a pool round
POST
/pool_rounds/
Create a pool round
DELETE
/pool_rounds/{pool_round_id}/
Delete a pool round

Bracket

GET
/brackets/
Get a list of brackets
GET
/brackets/{bracket_id}/
Get a bracket
PUT
/brackets/{bracket_id}/
Update a bracket
POST
/brackets/
Create a bracket
DELETE
/brackets/{bracket_id}/
Delete a bracket

Swiss Round

GET
/swiss_rounds/
Get a list of swiss rounds
GET
/swiss_rounds/{swiss_round_id}/
Get a swiss round
PUT
/swiss_rounds/{swiss_round_id}/
Update a swiss round
POST
/swiss_rounds/
Create a swiss round
DELETE
/swiss_rounds/{swiss_round_id}/
Delete a swiss round

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
GET
/event_sites/{event_site_id}/
Get an event site
PUT
/event_sites/{event_site_id}/
Update an event site
POST
/event_sites/
Create an event site
DELETE
/event_sites/{event_site_id}/
Delete an event site

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
GET
/game_sites/{game_site_id}/
Get a game site
PUT
/game_sites/{game_site_id}/
Update a game site
POST
/game_sites/
Create game site
DELETE
/game_sites/{game_site_id}/
Delete a game site

Events

Event

GET
/events/
Get a list of events
GET
/events/{event_id}/
Get an event
PUT
/events/{event_id}/
Update an event
POST
/events/
Create an event
DELETE
/events/{event_id}/
Delete an event

Player Stats

Player Stats Per Game

GET
/stats/{sport}/player_stats_per_game/
Get player stats for games
GET
/stats/{sport}/player_stats_per_game/{player_id}/{game_id}/

Player Stats Per Team

GET
/stats/{sport}/player_stats_per_team/
Get player stats for teams
GET
/stats/{sport}/player_stats_per_team/{player_id}/{team_id}/

Player Stats Per Tournament

GET
/stats/{sport}/player_stats_per_tournament/
GET
/stats/{sport}/player_stats_per_tournament/{player_id}/{tournament_id}/

Player Stats Per Season

GET
/stats/{sport}/player_stats_per_season/
Get player stats for seasons
GET
/stats/{sport}/player_stats_per_season/{player_id}/{season_id}/

Player Stats Per League

GET
/stats/{sport}/player_stats_per_league/
Get player stats for leagues
GET
/stats/{sport}/player_stats_per_league/{player_id}/{league_id}/

Player Stats Per Sport

GET
/stats/{sport}/player_stats_per_sport/
Get player stats for a sport
GET
/stats/{sport}/player_stats_per_sport/{player_id}/

Team Stats

Team Stats Per Game

GET
/stats/{sport}/team_stats_per_game/
Get team stats for games
GET
/stats/{sport}/team_stats_per_game/{team_id}/{game_id}/

Team Stats Per Tournament

GET
/stats/{sport}/team_stats_per_tournament/
GET
/stats/{sport}/team_stats_per_tournament/{team_id}/{tournament_id}/

Team Stats Per Season

GET
/stats/{sport}/team_stats_per_season/
Get team stats for seasons
GET
/stats/{sport}/team_stats_per_season/{team_id}/{season_id}/

Team Stats Per League

GET
/stats/{sport}/team_stats_per_league/
Get team stats for leagues
GET
/stats/{sport}/team_stats_per_league/{team_id}/{league_id}/

Team Stats Per Sport

GET
/stats/{sport}/team_stats_per_sport/
Get team stats for sports
GET
/stats/{sport}/team_stats_per_sport/{team_id}/