Leagues

Endpoint reference

Method	Route	Auth	Purpose
`GET`	`/leagues`	User	List active leagues
`GET`	`/admin/leagues`	Admin	List all leagues (including inactive)
`POST`	`/admin/leagues`	Admin	Create a league
`PATCH`	`/admin/leagues/:id`	Admin	Update a league
`DELETE`	`/admin/leagues/:id`	Admin	Delete 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.

string

required

League name (e.g., “Big Bash League”).

string

required

Short code (e.g., “BBL”).

string

required

Season identifier (e.g., “2025-26”).

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.

Devices Teams

Overview

Endpoints

Endpoint reference

GET /leagues `User`

Admin league management

GET /admin/leagues `Admin`

POST /admin/leagues `Admin`

PATCH /admin/leagues/:id `Admin`

DELETE /admin/leagues/:id `Admin`

​Endpoint reference

​GET /leagues User

​Admin league management

​GET /admin/leagues Admin

​POST /admin/leagues Admin

​PATCH /admin/leagues/:id Admin

​DELETE /admin/leagues/:id Admin

Endpoint reference

GET /leagues `User`

Admin league management

GET /admin/leagues `Admin`

POST /admin/leagues `Admin`

PATCH /admin/leagues/:id `Admin`

DELETE /admin/leagues/:id `Admin`