Get Club Seasons
Query Parameters
integer
required
Club ID to retrieve seasons for
Response
Returns an array of seasons for the club.integer
Unique identifier for the season
string
Season year in format “YYYY” or “YYYY-YY” (e.g., “2024” or “2024-25”)
This endpoint is cached for optimal performance. Results include only seasons where the club has available kits.
Search Seasons
Query Parameters
string
required
Year or partial year to search for. Supports various formats:
- Full year: “2025” (matches “2025”, “2024-25”, “2025-26”)
- Partial year with dash: “2025-” (matches “2024-25”, “2025-26”)
- Full season: “2020-21” (matches exactly “2020-21”)
- Two-digit year: “97” (matches “1997”, “1996-97”)
Response
Returns an array of up to 10 matching seasons.integer
Unique identifier for the season
string
Season year in format “YYYY” or “YYYY-YY”
Search Priority
Results are ordered by relevance:- Exact match - “2025” matches “2025”
- Starts with keyword - “2025” matches “2025-26” (first_year matches)
- Ends with keyword - “2025” matches “2024-25” (second_year matches)
- Contains keyword - “2025” matches “2025-27” (in first_year or second_year)
- Priority 2: first_year ends with “97” (e.g., “1997”)
- Priority 3: second_year ends with “97” (e.g., “1996-97”)
Examples
Results are cached for optimal performance and limited to 10 matches.
Get Season by ID
Path Parameters
integer
required
The unique identifier of the season
Response
integer
Unique identifier for the season
string
Season year in format “YYYY” or “YYYY-YY”