Seasons By Tournament

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

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 tournament_id
https://football.sportdevs.com/seasons-by-tournament?tournament_id=eq.{tournament_id}

Query Parameters

• tournament_id integer

  Default value: eq.1

  The id of the tournament

• offset string

  Default value: 0

  Limiting and Pagination

• limit string

  Default value: 50

  Limiting and Pagination

• lang string

  Default value: en

  Multi-language

Responses

• 200

---

OK

application/json

• Schema
• Example (from schema)

---

Schema array

• tournament_id integer

  The id of the tournament

  Note: This is a Primary Key.

• tournament_name text

  The name of the tournament

• seasons jsonb

  The seasons

[
  {
    "tournament_id": 1,
    "tournament_name": "Omani League",
    "seasons": [
      {
        "id": 2340,
        "name": "Omani League 23/24",
        "year": "23/24"
      },
      {
        "id": 2506,
        "name": "Omani League 22/23",
        "year": "22/23"
      },
      {
        "id": 2524,
        "name": "Omani League 21/22",
        "year": "21/22"
      },
      {
        "id": 2552,
        "name": "Omani League 20/21",
        "year": "20/21"
      },
      {
        "id": 2707,
        "name": "Omani League 19/20",
        "year": "19/20"
      },
      {
        "id": 2770,
        "name": "Omani League 18/19",
        "year": "18/19"
      },
      {
        "id": 2793,
        "name": "Omani League 17/18",
        "year": "17/18"
      },
      {
        "id": 2840,
        "name": "Omani League 16/17",
        "year": "16/17"
      },
      {
        "id": 2883,
        "name": "Omani League 15/16",
        "year": "15/16"
      },
      {
        "id": 2910,
        "name": "Omani League 14/15",
        "year": "14/15"
      },
      {
        "id": 2944,
        "name": "Omani League 13/14",
        "year": "13/14"
      },
      {
        "id": 2977,
        "name": "Omani League 12/13",
        "year": "12/13"
      },
      {
        "id": 3016,
        "name": "Omani League 11/12",
        "year": "11/12"
      }
    ]
  }
]

Loading...