Get league by ID

GET

/api/v1/leagues/{id}

const url = 'https://internal.myscore.live/api/v1/api/v1/leagues/lg_abc123';
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/lg_abc123

Public endpoint. Returns a single league with its championship reference.

Parameters

Path Parameters

required

string

Example

lg_abc123

League ID

Responses

200

League details

application/json

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"
}

404

League not found