LeagueLobster API
Please let us know if you need any assistance. The best way to reach out is the help chat on the main site or at help.leaguelobster.com.<p>To make requests, first obtain an access token, then include it in your request header as `Authorization: JWT <your_token>`.</p>
access-token
create
API View that receives a POST with a user's username and password. Returns a JSON Web Token that can be used for authenticated requests.
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
password required | |
username required |
access-token-logged-in
association
divisions > list
List all divisions in an association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
divisions > create
Add a division to an association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
title required | |
rank | Divisions are sorted on this in ascending order. |
divisions > read
Retrieve a division in an association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required | |
division_id required |
divisions > update
Update a division in an association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required | |
division_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
title required | |
rank | Divisions are sorted on this in ascending order. |
divisions > partial_update
Update a division in an association (only modifies fields passed in the request).
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required | |
division_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
title | |
rank | Divisions are sorted on this in ascending order. |
leagues > list
Return list of all Leagues under the given Association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
leagues > create
Create a new league under the given Association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name required | e.g. Monday Night Football |
description | Shown to users in League Lists and on registration pages. |
sport | |
association required |
leagues > read
Retrieve a league under the given Association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required | |
league_id required |
leagues > update
Update a league under the given Association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required | |
league_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name required | e.g. Monday Night Football |
description | Shown to users in League Lists and on registration pages. |
sport | |
association required |
leagues > partial_update
Partially update a league under the given Association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required | |
league_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name | e.g. Monday Night Football |
description | Shown to users in League Lists and on registration pages. |
sport | |
association |
matches > list
Return a list of all Matches for a given Association.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
association_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
match
read
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
update
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
week | |
start | remove Timeslot if editing manually |
home_score | |
home_points | |
away_score | |
away_points | |
friendly | not counted in standings |
comment | |
locked | Locks the game when scheduling |
home_forfeit | |
away_forfeit | |
season | |
playoff_fixture | |
home_team required | |
away_team required | |
venue | remove Timeslot if editing manually |
referee | |
assistant_referees |
partial_update
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
week | |
start | remove Timeslot if editing manually |
home_score | |
home_points | |
away_score | |
away_points | |
friendly | not counted in standings |
comment | |
locked | Locks the game when scheduling |
home_forfeit | |
away_forfeit | |
season | |
playoff_fixture | |
home_team | |
away_team | |
venue | remove Timeslot if editing manually |
referee | |
assistant_referees |
delete
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
referee
matches > list
Return a list of all Matches for a given Referee.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
referee_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
season
list
Return a list of all seasons for current user.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
create
Create a new season.
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
league_name_input | Provide this to create a new league instance, e.g. "Monday Night Women's Soccer" |
league | ID of an existing league. One of `league` or `league name` is required. |
name required | Season name, e.g. "Spring 2019" |
numweeks required | Number of weeks in your season (excl. off-weeks). |
numgames required | Total number of games per team (excl. playoffs) |
duration_game | Match duration in minutes; default: 60 |
association_name | If creating a new league (by providing league_name and not league), must provide either `association_name` or `association` |
association | see association_name; ignored if league id given |
startdate | datetime; default: today + 2 weeks |
enddate | datetime; default: startdate + numweeks |
tournament | boolean; True to use tournament scheduler; False to use league scheduler (see pricing) |
partner | |
draft | boolean; True if the season is in draft mode (hidden from public lists) |
read
Return details for a given season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
update
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name required | e.g. Spring 2026 |
startdate | |
enddate | |
numweeks | Enter number of weeks/match days in this season. |
numgames | [optional] Enter number of games each team will play. Only required if you want to generate a schedule with doubleheaders, i.e. more games than weeks. |
duration_game | Time allocation per game IN MINUTES (for scheduling purposes). |
duration_game_display | Duration as displayed to players, e.g. 2 x 25 mins |
open_registration | leave blank to open right away |
close_registration | leave blank to close on event start date |
max_teams | Registration will be automatically closed when this many teams have registered and paid (or have been manually included in schedule). |
price | |
individual_price | price per player when paying individually |
draft | |
league required |
partial_update
Update only specified fields on a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name | e.g. Spring 2026 |
startdate | |
enddate | |
numweeks | Enter number of weeks/match days in this season. |
numgames | [optional] Enter number of games each team will play. Only required if you want to generate a schedule with doubleheaders, i.e. more games than weeks. |
duration_game | Time allocation per game IN MINUTES (for scheduling purposes). |
duration_game_display | Duration as displayed to players, e.g. 2 x 25 mins |
open_registration | leave blank to open right away |
close_registration | leave blank to close on event start date |
max_teams | Registration will be automatically closed when this many teams have registered and paid (or have been manually included in schedule). |
price | |
individual_price | price per player when paying individually |
draft | |
league |
delete
Delete a given season. Use caution, this cannot be undone.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
copy > create
Copy a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
new_league | Boolean; Default is False. If True, a new league will be created |
copy_teams | Boolean; Default is False. If True, teams from the existing season will be copied |
new_teams | Boolean; Default is True. If False, existing teams will be used |
copy_matches | Boolean; Default is False. If True, matches from the existing season will be copied |
clear_scores | Boolean; Default is True. If False, scores from the copied matches will be kept |
clear_referees | Boolean; Default is False. If True, referees from the copied matches will be cleared |
copy_registration_settings | Boolean; Default is True. If False, registration settings from the existing season will not be copied |
divisions > list
List all divisions in a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
divisions > create
Add a division to a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
season required | |
division required | |
max_teams | maximum number of teams allowed to register |
number_of_matches | number of matches |
divisions > read
Retrieve a division in a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
division_id required |
divisions > update
Update a division in a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
division_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
season required | |
division required | |
max_teams | maximum number of teams allowed to register |
number_of_matches | number of matches |
divisions > partial_update
Update a division in a season (only modifies fields passed in the request).
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
division_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
season | |
division | |
max_teams | maximum number of teams allowed to register |
number_of_matches | number of matches |
divisions > delete
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
division_id required |
divisions > bulk > create
Add multiple divisions to a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
ids required |
divisions > bulk > delete
Remove multiple divisions from a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
matches > list
Return a list of all Matches in the given Season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
matches > create
Add a Match or list of Matches to the given Season. Accepts either a dict (to create a single Match) or a list of dicts to (create multiple Matches).
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
week | |
start | naive datetime |
home_score | |
home_points | |
away_score | |
away_points | |
friendly | set True to exclude game from standings |
comment | |
locked | Locks the game when scheduling |
home_forfeit | |
away_forfeit | |
season required | needs to match URL |
playoff_fixture | |
home_team required | |
away_team required | |
venueavail | |
venue | remove Timeslot if editing manually |
referee | |
assistant_referees |
matches > delete
Delete all Matches in the given Season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
standings > list
Return standings data for a given Season, grouped by Division and Group/Pool.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
team > read
List all teams in the given season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
team_id required |
team > create
Add an existing team to a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
team_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
id | Team ID. Ignored if team_id is passed (via url). |
name | Team name. |
division | Division ID |
division_name | Division name. Ignored if division ID is passed. Will use existing division if found in season's association, otherwise creates a new division. |
group | Group (pool) ID |
team > update
Update a team's division and/or group.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
team_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
id | Team ID. Ignored if team_id is passed (via url). |
name | Team name. |
division | Division ID |
division_name | Division name. Ignored if division ID is passed. Will use existing division if found in season's association, otherwise creates a new division. |
group | Group (pool) ID |
team > partial_update
Update a team's division and/or group (pass season id and team id and the new division id or division name and or the new group id).
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
team_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
id | Team ID. Ignored if team_id is passed (via url). |
name | Team name. |
division | Division ID |
division_name | Division name. Ignored if division ID is passed. Will use existing division if found in season's association, otherwise creates a new division. |
group | Group (pool) ID |
team > delete
Remove a team from a season. The team itself will not be deleted, so it will still be available in any other seasons it may be attached to.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
team_id required |
teams > list
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
teams > create
Add a team (dict) or list of teams (list of dicts) to a season. Passing team_id uses existing team, passing team_name without team_id creates a new team. Passing a division (id) will use an existing division, passing a division name without an id will create a new division.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
id | Team ID. Ignored if team_id is passed (via url). |
name | Team name. |
division | Division ID |
division_name | Division name. Ignored if division ID is passed. Will use existing division if found in season's association, otherwise creates a new division. |
group | Group (pool) ID |
venues > list
Get the related items of a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
venues > create
Add related items to a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
ids required |
venues > delete
Remove related items from a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required |
venues > read
Get the related items of a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
item_id required |
venues > create_0
Add related items to a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
item_id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
ids required |
venues > delete_0
Remove related items from a season.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
season_id required | |
item_id required |
team
list
Lists all Teams for all of the user's Associations.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
read
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
team required |
update
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
team required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name | Team name |
partial_update
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
team required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name | Team name |
delete
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
team required |
matches > list
Return a list of all Matches for a given Team.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
team_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
user
lookup > list
Look up users by email address. Query parameters: - email: The email address to look up (required)
venue
list
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
create
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name required | |
address | |
city | |
state | |
zipcode | |
country | |
info | e.g. venue website |
order | Venues are sorted on this in ascending order. |
master | |
position | drag the pin to the approximate position of the entrance |
associations |
read
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
update
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name required | |
address | |
city | |
state | |
zipcode | |
country | |
info | e.g. venue website |
order | Venues are sorted on this in ascending order. |
master | |
position | drag the pin to the approximate position of the entrance |
associations |
partial_update
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
name | |
address | |
city | |
state | |
zipcode | |
country | |
info | e.g. venue website |
order | Venues are sorted on this in ascending order. |
master | |
position | drag the pin to the approximate position of the entrance |
associations |
delete
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
id required |
verify-token
create
API View that checks the validity of a token, returning the token if it is valid.
Request Body
The request body should be a "application/json" encoded object, containing the following items.
| Parameter | Description |
|---|---|
token required |