Seasons

List and manage competition seasons.

The Seasons API offers endpoints that allow the retrieval of comprehensive season data, including specific competition dates, team participation, and critical event details. This API supports a range of filtering options, enabling users to tailor their queries to specific seasons, teams, or time frames. This page aims to simplify integrating sports season data into applications, enhancing the richness and relevance of sports-related content.

Endpoints

List seasons

GET https://dde-api.data.imgarena.com/ice-hockey/seasons

Retrieves a list of seasons for a specific sport.

Query Parameters

Name	Type	Description
type	string	Official, Training or Simulation matches

Headers

Name	Type	Description
Accept*	string	application/vnd.imggaming.dde.api+json;version=1
Authorization*	string	Bearer ACCESS_TOKEN
Content-Type*	string	application/json

400: Bad Request

{
    Request is missing required HTTP header 'Accept'
}

401: Unauthorized

{
    The supplied authentication is invalid
}

200: OK Response JSON

Response JSON

{
        "id": "2771c1d9-3688-4972-ba6e-3ef433c9c5f3",
        "name": "2023",
        "startDateUTC": "2023-08-26T12:00:00",
        "endDateUTC": "2023-11-30T12:00:00",
        "competition": {...},
        "stages": [...]
}

Response object

Response object	Response type	Description
seasons	Season	The requested list of seasons.

Rate limits

Rate limit	Note
Tier 2