Teams By Season

This endpoint allows you to retrieve the teams from a specific season.

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 teams from a specific season_id
https://handball.sportdevs.com/teams-by-season?season_id=eq.{season_id}

Query Parameters

• season_id integer

  Default value: eq.11935

  The id of the season

• 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

• season_id integer

  The id of the season

  Note: This is a Primary Key.

• season_name text

  The name of the season

• teams jsonb

  The teams

[
  {
    "season_id": 11935,
    "season_name": "World Championship Qualification 2025",
    "teams": [
      {
        "team_id": 42649,
        "team_name": "Lithuania",
        "team_hash_image": "33f933d7308dd5dba8721df5183920e0366bf744562d3db26608538b559c7df1"
      },
      {
        "team_id": 42673,
        "team_name": "Slovakia",
        "team_hash_image": "1b6fd80346689d80f1236d7d032d15057b932d049adb1ed6f4f8105616644105"
      },
      {
        "team_id": 42773,
        "team_name": "Israel",
        "team_hash_image": "d22d7a626922f934ee6d8091ce246b05aa715353b0ac8dd0d66c3c8b3c8a2e24"
      },
      {
        "team_id": 42836,
        "team_name": "Finland",
        "team_hash_image": "5b84cb63ecc4c504ee9fab3a783fa81a660df0d91c70de28ba65c8ca4c7ab421"
      },
      {
        "team_id": 43025,
        "team_name": "Italy",
        "team_hash_image": "0fe5018e113390a398158b725ec096cf424475d00bd35f483388552b65e535fc"
      },
      {
        "team_id": 43037,
        "team_name": "Turkey",
        "team_hash_image": "ff3cca8480b6e556eaff8223178247dddee4559475a37b07e35ba30392b7f5bb"
      },
      {
        "team_id": 43057,
        "team_name": "Belgium",
        "team_hash_image": "9648b6eb3b4d156bdc8699f554841c841afa57211be54d1b12ed8da3d6ec7bc2"
      },
      {
        "team_id": 43155,
        "team_name": "Ukraine",
        "team_hash_image": "52d8d003b604cd988054b3cd41192dc4b696620220455b3ac3ecea3e16d859e6"
      },
      {
        "team_id": 43189,
        "team_name": "Estonia",
        "team_hash_image": "821bf5e02585ba1061d5fa202b9d076123dfba1f2d59d67f14d9dfb374ea1129"
      },
      {
        "team_id": 43460,
        "team_name": "Belarus",
        "team_hash_image": "fa945c7a77c3e28373b2c3290491a2a11fd38aa9213eab013963b39d610cd0a8"
      }
    ]
  }
]

Loading...