# Seasons API

This endpoint lists the soccer competition seasons and will be the gateway into the fixtures API. Information within this endpoint can be filtered by the start/end date of a season and is useful for obtaining competition id's, season id's, stage id's. Key information within the response is as follows:

* Name of the competition
* Competition & Season Id
* Start & End Dates
* Stage/Round/Group information

## Endpoint URLs

#### All seasons (all competitions):

#### `https://dde-api.data.imgarena.com/soccer/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:<br>

| REST Endpoint   | Frequency         | Description                                           |
| --------------- | ----------------- | ----------------------------------------------------- |
| /soccer/seasons | Once per 12 hours | Updated on any change to seasons, competitions, dates |

## Required Headers

| Key           | Value                                            |
| ------------- | ------------------------------------------------ |
| Accept        | application/vnd.imggaming.dde.api+json;version=1 |
| Content-Type  | application/json                                 |
| Authorization | Bearer eyvhaoudfgpdfgo\*                         |

## Response Model

For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:

JSON Schema - <https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-SOCCER/1#/football/get_soccer_seasons>

JSON Schema with value descriptions - <https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-SOCCER/1#/Season>