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:

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

Last updated