Teams Seasons

This endpoint allows you to retrieve the seasons from teams.

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 team_id
https://handball.sportdevs.com/teams-seasons?team_id=eq.{team_id}

Query Parameters

• team_id integer

  Default value: eq.1241

  The id of the team

• 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

• team_id integer

  The id of the team

  Note: This is a Primary Key.

• team_name text

  The name of the team

• team_hash_image character varying

  Possible values: <= 64 characters

  The hash image of the team

• tournaments jsonb

  The tournaments of the team playing

[
  {
    "team_id": 1241,
    "team_name": "Porto",
    "team_hash_image": "2d09b7f663bcc68afe1afead2ae98120ec66cae97599e81883c5db56a66fdf8c",
    "tournaments": [
      {
        "seasons": [
          {
            "season_id": 5947,
            "start_time": "2020-08-15",
            "season_name": "20/21"
          },
          {
            "season_id": 5897,
            "start_time": "2022-08-13",
            "season_name": "Srpska Liga Istok 22/23"
          },
          {
            "season_id": 5921,
            "start_time": "2021-08-13",
            "season_name": "Srpska Liga Istok 21/22"
          },
          {
            "season_id": 5861,
            "start_time": "2023-08-12",
            "season_name": "23/24"
          },
          {
            "season_id": 58906,
            "season_name": "19/20"
          },
          {
            "season_id": 58914,
            "season_name": "18/19"
          },
          {
            "season_id": 48001,
            "start_time": "2024-08-10",
            "season_name": "Srpska Liga Istok 24/25"
          }
        ],
        "tournament_id": 626,
        "tournament_name": "1a Divisao"
      }
    ]
  }
]

Loading...