Seasons

The Seasons API offers developers a convenient way to list and manage competition seasons.

Serving as a gateway to the Fixtures API, it provides seamless integration for accessing comprehensive sports-related data.

Key Features:

• List and Manage Competition Seasons: With the Seasons API, developers can effortlessly retrieve a complete list of competition seasons. No specific input is required from applications, making it easy to obtain general season information.

• Flexible Filtering Options: Developers can leverage the API's filtering capabilities to retrieve seasons based on desired start and end dates. This feature allows applications to narrow down the results to specific time frames.

Useful Results: The API provides valuable results for obtaining essential identifiers, including competition IDs, season IDs, and stage IDs.

This pages provides in-depth information on endpoints, request parameters, and response structures. By following the provided guidelines and examples, developers can seamlessly integrate the API into their applications and maximize competition season management capabilities.

Endpoints

List seasons

GET https://dde-api.data.imgarena.com/v2/volleyball/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

{
    "id": "ca1829d1-fc05-455a-90e1-1692b2eb1306",
        "name": "Season 2022/2023",
        "startDateUTC": "2022-09-19T00:00:00",
        "endDateUTC": "2022-10-31T00:00:00",
        "competition": {
            "id": "10d45772-74a0-4703-ae40-804591a0fb80",
            "name": "Israel League Cup",
            "category": {
                "id": 1,
                "name": "Men"
            },
            "location": {
                "name": "Israel",
                "country": {},
                "continent": {
                    "name": "Asia"
                }
            }
        },
        "stages": [
            {
                "id": "b14d07d6-77ac-4aae-abbd-8da9125cfbf2",
                "name": "Regular Round",
                "startDateUTC": "2022-09-19T00:00:00",
                "endDateUTC": "2022-10-31T00:00:00",
                "rounds": [],
                "groups": []
            }
        ]
}

Response Fields

seasons	The requested list of seasons.

Polling frequency

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times - once per 12 hours

Pagination

Please find the following link to the pagination page.

We kindly request your thorough perusal of this section in order to familiarize yourself with forthcoming alterations scheduled for implementation on the 31st of July, 2023.

These modifications, primarily encompassing the introduction of supplementary parameters, are anticipated to be of a straightforward nature and aim to enhance the query efficiency of our Fixtures API, thereby affording you considerable advantages.