# 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

<mark style="color:blue;">`GET`</mark> `https://dde-api.data.imgarena.com/v2/tabletennis/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<mark style="color:red;">\*</mark>        | string | application/vnd.imggaming.dde.api+json;version=1 |
| Authorization<mark style="color:red;">\*</mark> | string | Bearer ACCESS\_TOKEN                             |
| Content-Type<mark style="color:red;">\*</mark>  | string | application/json                                 |

{% tabs %}
{% tab title="400: Bad Request " %}

```json
{
    Request is missing required HTTP header 'Accept'
}
```

{% endtab %}

{% tab title="401: Unauthorized " %}

```json
{
    The supplied authentication is invalid
}
```

{% endtab %}

{% tab title="200: OK " %}

```json
{
  "id": "ff88b9c6-6598-4d05-88c5-c87751e64380",
  "name": "reg",
  "startDateUTC": "2025-05-01T12:00:00",
  "endDateUTC": "2025-05-31T12:00:00",
  "competition": {
    "id": "bd9b6a78-5024-4d38-92f9-8add0ad8eaa2",
    "name": "3108 WTT import men single sen",
    "type": "Official",
    "category": {
      "id": 1,
      "name": "Men"
    },
    "format": {
      "id": 251322,
      "name": "singles"
    },
    "location": {
      "name": "Qatar",
      "country": {},
      "continent": {
        "name": "Asia"
      }
    },
    "commentCount": 0
  },
  "stages": [
    {
      "id": "b9201033-f0bd-465a-a873-d391239f86b3",
      "name": "reg",
      "startDateUTC": "2025-05-01T12:00:00",
      "endDateUTC": "2025-05-31T12:00:00",
      "rounds": [],
      "groups": []
    }
  ],
  "sport": "Table Tennis"
}
```

{% endtab %}
{% endtabs %}

## Response Fields

<table data-header-hidden><thead><tr><th width="178">Property</th><th>Description</th></tr></thead><tbody><tr><td>seasons<br></td><td>The requested list of seasons.<br></td></tr></tbody></table>

## 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](https://docs.sportradar.com/table-tennis/table-tennis-multisport/rest-api/broken-reference) page.

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 Seasons API, thereby affording you considerable advantages.