Fixtures API

This endpoint returns the competition fixtures for a specific season. Per each competition, this endpoint will return the following information:

  • Name of the competition

  • Fixture date and kick-off time

  • Home and Away team (with IDs)

  • Venue

  • Stage/Round/Group information

  • Status (scheduled, live, completed, postponed)

Endpoint URLs

* Live Fixtures (Subscribed):

https://dde-api.data.imgarena.com/soccer/fixtures?live=true&subscribed=true

OR

https://dde-api.data.imgarena.com/soccer/seasons/{seasonId}/fixtures?live=true&subscribed=true

This allows clients to determine which fixtures are live and available based on a user's licence. The top URL shows all live fixtures and the bottom shows all live fixtures within that seasonId (e.g. MLS 2021/22).

  • Fixtures (Subscribed):

https://dde-api.data.imgarena.com/soccer/fixtures?subscribed=true

OR

https://dde-api.data.imgarena.com/soccer/seasons/{seasonId}/fixtures?subscribed=true

The top URL lists the fixtures for which you a user is licensed, and the bottom URL the fixtures within a specific seasonId (e.g. MLS 2021/22), that a user is licensed for.

  • All Fixtures (Unsubscribed):

https://dde-api.data.imgarena.com/soccer/fixtures

OR

https://dde-api.data.imgarena.com/soccer/seasons/{seasonId}/fixtures

This top URL lists the fixtures for all competitions (licensed and unlicensed). This is useable for an operator to see what which competitions might be available to purchase from IMGA. The bottom URL is a list of fixtures for a specific seasonId (e.g. MLS 2021/22), both licensed and unlicensed.

  • Single Fixture

https://dde-api.data.imgarena.com/soccer/fixtures/{fixtureId}

This allows clients to determine the details for a single fixture

  • Status & dateTo and dateFrom (added 3rd Aug 2022)

https://dde-api.data.imgarena.com/soccer/fixtures?subscribed=true&status=scheduled&dateFrom=2022-07-07&dateTo=2022-07-10

This allows clients to filter based on the status of a match or group of matches and between specific dates. For example, the above URL would show all matches that are 'scheduled' that a client is a licensed for between 7th July 2022 and 10th July 2022. These additional parameters can be used in conjunction with other support parameters like ?live=true and also be utilised with seasonId to allow a user to filter by status and dateTo and dateFrom within a certain season.

Supported status values are 'scheduled', 'live', 'completed', 'postponed'

  • type (addd August 2022)

Type parameter allows a user to call the fixtures API by 'Official', 'Simulation' or 'Training'. Official will denote any official match collected by our data collection team, Simulation is generally any match we simulate and Training is for internal data collection training.

https://dde-api.data.imgarena.com/soccer/fixtures?dateFrom=2022-09-01&dateTo=2022-09-30&type=official

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:

API
REST Endpoint
Frequency
Description

Live Fixtures (Subscribed)

/soccer/fixtures?live=true&subscribed=true OR soccer/seasons/{seasonId}/fixtures?live=true&subscribed=true

Every 30 seconds for a fixture

Live fixtures for which a client is licensed. This allows clients to determine which fixtures are live and available.

Fixtures (Subscribed)

/soccer/fixtures?subscribed=true OR /soccer/seasons/{seasonId}/fixtures?subscribed=true

Every 60 seconds for an upcoming fixture

The fixtures for a competition for which a client is licensed.

All Fixtures (Unsubscribed)

/soccer/fixtures

OR /soccer/seasons/{seasonId}/fixtures

Every 24 hours

Lists ALL the fixtures for all competitions. This is useful to determine what IMGA covers for that sport.

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_fixtures

https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-SOCCER/1#/football/getFixturesBySeasonId

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

Last updated