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:
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