Skip to main content

​
Endpoint reference

MethodRouteAuthPurpose
GET/leaguesUserList active leagues
GET/admin/leaguesAdminList all leagues (including inactive)
POST/admin/leaguesAdminCreate a league
PATCH/admin/leagues/:idAdminUpdate a league
DELETE/admin/leagues/:idAdminDelete a league

​
GET /leagues User

Returns all active leagues. 
{
  "leagues": [
    {
      "id": "bbl",
      "name": "Big Bash League",
      "season": "2025-26",
      "status": "active"
    }
  ]
}

​
Admin league management

​
GET /admin/leagues Admin

List all leagues, including inactive ones.

​
POST /admin/leagues Admin

Create a new league.
​
name
string
required
League name (e.g., “Big Bash League”).
​
shortName
string
required
Short code (e.g., “BBL”).
​
season
string
required
Season identifier (e.g., “2025-26”).
​
sportMonksLeagueId
number
SportMonks league ID.

​
PATCH /admin/leagues/:id Admin

Update league properties. Can be used to activate/deactivate a league.

​
DELETE /admin/leagues/:id Admin

Delete a league. This does not delete associated matches or fixtures.
Deleting a league that has active matches may cause unexpected behavior. Deactivate it instead.