List leagues

GET

/api/v1/leagues

const url = 'https://internal.myscore.live/api/v1/api/v1/leagues';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://internal.myscore.live/api/v1/api/v1/leagues

Public endpoint. Lists leagues, optionally filtered by championship.

Parameters

Query Parameters

championshipId

string

Filter by parent championship ID

Responses

200

List of leagues

application/json

Array<object>

object

required

League ID

string

championshipId

required

Parent championship ID

string

name

required

League name

string

category

required

League category (active, youth, senior)

string

gender

Gender restriction (male, female, mixed)

string

nullable

ageGroup

Age group label (e.g. Open, U18, 50+)

string

nullable

tier

Tier within the championship (1 = top division)

number

nullable

defaultSinglesCount

required

Default number of singles matches per team match

number

defaultDoublesCount

required

Default number of doubles matches per team match

number

defaultMatchFormat

Default match format

string

nullable

defaultMatchTiebreakTo

Default match-tiebreak target points

number

nullable

createdAt

required

Record creation timestamp

string format: date-time

updatedAt

required

Record last update timestamp

string format: date-time

Example

[
  {
    "id": "lea_abc123",
    "championshipId": "chp_abc123",
    "name": "Bezirksklasse 1",
    "category": "active",
    "gender": "male",
    "ageGroup": "Open",
    "tier": 1,
    "defaultSinglesCount": 6,
    "defaultDoublesCount": 3,
    "defaultMatchFormat": "best_of_3_mtb",
    "defaultMatchTiebreakTo": 10,
    "createdAt": "2026-03-01T12:00:00.000Z",
    "updatedAt": "2026-03-01T12:00:00.000Z"
  }
]

429

Rate limit exceeded