Seasons By League

This endpoint allows you to retrieve the seasons from a specific league.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated every day.
Recommended Calls: Limit calls to 1 per day.

Use Cases

Get seasons from a specific league_id
https://darts.sportmicro.com/seasons-by-league?league_id=eq.{league_id}

Query Parameters

• league_id integer

  The id of the league

  Example: eq.59
• offset string

  Default value: 0

  Limiting and Pagination

  Example: 0
• limit string

  Default value: 50

  Limiting and Pagination

  Example: 50
• lang string

  Default value: en

  Multi-language

  Example: en

Responses

• 200

---

OK

application/json

• Schema
• Example (from schema)

---

Schema array

• league_id integer

  The id of the league

  Note: This is a Foreign Key to leagues.id.

• league_name text

  The name of the league

• league_hash_image text

  The hash image of the league

• seasons jsonb

  The seasons

[
  {
    "league_id": 59,
    "league_name": "PDC World Championship",
    "league_hash_image": "b36d3447d325791b2bee7ba3dc29a0dd30686eadf739b4ac5b2794917bcda980",
    "seasons": [
      {
        "id": 61,
        "name": "PDC World Championship 2026",
        "year": "25/26",
        "start_time": "2025-12-12"
      },
      {
        "id": 26992,
        "name": "PDC World Championship 24/25",
        "year": "24/25",
        "start_time": "2024-12-22"
      },
      {
        "id": 28985,
        "name": "PDC World Championship 23/24",
        "year": "23/24",
        "start_time": "2023-12-16"
      },
      {
        "id": 30036,
        "name": "PDC World Championship 22/23",
        "year": "22/23",
        "start_time": "2022-12-17"
      },
      {
        "id": 30828,
        "name": "PDC World Championship 21/22",
        "year": "21/22",
        "start_time": "2021-12-17"
      },
      {
        "id": 31352,
        "name": "PDC World Championship 20/21",
        "year": "20/21",
        "start_time": "2020-12-18"
      },
      {
        "id": 31732,
        "name": "PDC World Championship 19/20",
        "year": "19/20",
        "start_time": "2020-01-01"
      },
      {
        "id": 31988,
        "name": "PDC World Championship 18/19",
        "year": "18/19",
        "start_time": "2018-12-22"
      },
      {
        "id": 32229,
        "name": "PDC World Championship 17/18",
        "year": "17/18",
        "start_time": "2017-12-28"
      },
      {
        "id": 32509,
        "name": "PDC World Championship 16/17",
        "year": "16/17",
        "start_time": "2017-01-02"
      },
      {
        "id": 32838,
        "name": "PDC World Championship 15/16",
        "year": "15/16",
        "start_time": "2016-01-03"
      },
      {
        "id": 33187,
        "name": "PDC World Championship 14/15",
        "year": "14/15",
        "start_time": "2014-12-19"
      },
      {
        "id": 33497,
        "name": "PDC World Championship 13/14",
        "year": "13/14",
        "start_time": "2013-12-14"
      },
      {
        "id": 33696,
        "name": "PDC World Championship 12/13",
        "year": "12/13",
        "start_time": "2012-12-14"
      },
      {
        "id": 33851,
        "name": "PDC World Championship 11/12",
        "year": "11/12",
        "start_time": "2011-12-15"
      },
      {
        "id": 34019,
        "name": "PDC World Championship 10/11",
        "year": "10/11",
        "start_time": "2010-12-16"
      },
      {
        "id": 34269,
        "name": "PDC World Championship 09/10",
        "year": "09/10",
        "start_time": "2009-12-18"
      },
      {
        "id": 34410,
        "name": "PDC World Championship 08/09",
        "year": "08/09",
        "start_time": "2008-12-20"
      }
    ]
  }
]

Loading...