List all fixtures.
The Fixtures API lets developers list and manage season fixtures. This is a gateway into the Actions API.
Applications don't need any input to list all fixtures, however information can be filtered by start date and end date. The result is useful for obtaining competiton Ids, season Ids, and stage Ids.
GET
https://dde-api.data.imgarena.com/{sport}/fixtures
Retrieves a list of seasons for a specific sport.
sport*
String
A unique name for the requested sport. Example: basketball
, soccer
, v2/volleyball
, snooker
String
subscribed
Boolean
Lists the fixtures for which a user is licensed. Example: true
, false
live
Boolean
Allows users to determine which fixtures are live and available based on a user's licence. Example: true
, false
status
String
Allows clients to filter based on the status of a match or group of matches. Example: scheduled
, live
, completed
, postponed
dateFrom
Date
DAllows clients to filter between specific dates. Example: 2023-01-01
dateTo
Date
Allows clients to filter between specific dates. Example: 2023-01-01
type
String
Allows clients to filter based on the type of a match or group of matches. Example: official
, simulation
, training
coverageLevel
String
Accept*
String
application/vnd.imggaming.dde.api+json;version=1
Authorization*
String
Bearer ACCESS_TOKEN
Content-Type*
String
application/json
GET
https://dde-api.data.imgarena.com/{sport}/seasons/{seasonId}/fixtures
sport*
String
A unique name for the requested sport. Example: basketball
, soccer
, v2/volleyball
, snooker
seasonId*
UUID
unique id of a requested season
subscribed
Boolean
Lists the fixtures for which a user is licensed. Example: true
, false
live
Boolean
Allows users to determine which fixtures are live and available based on a user's licence. Example: true
, false
status
String
Allows clients to filter based on the status of a match or group of matches. Example: scheduled
, live
, completed
, postponed
dateFrom
Date
Allows clients to filter between specific dates. Example: 2023-01-01
dateTo
Date
Allows clients to filter between specific dates. Example: 2023-01-01
type
String
Allows clients to filter based on the type of a match or group of matches. Example: official
, simulation
, training
GET
https://dde-api.data.imgarena.com/{sport}/fixtures/{fixtureId}
sport*
String
A unique name for the requested sport. Example: basketball
, soccer
, v2/volleyball
, snooker
fixtureId*
UUID
Unique id of a requested fixture.
The requested list of seasons
id (uuid
) - The FastPath-assigned ID of the fixture
name (string
) - Descriptive name of the fixture
startDateUTC (datetime
) - Start date of the fixture
status (string
) - Competition information within the season
type (string
) - Round of match within a competition
coverageLevel (string
) - Round of match within a competition
teams (Teams
) - Round of match within a competition
stage (Stage
) - Round of match within a competition
venue (Venue
) - Round of match within a competition
id (uuid
) - The FastPath-assigned ID of the competition within the season
name (string
) - Name of the competition. Example: Israel League Cup
club (Club
) - Competition category information
category (Category
) - Competition category information
homeTeam (boolean
) - Venue information of the competition
name
id (uuid
) -
name (string
) -
season (Season
) -
startDateUTC (datetime
) -
endDateUTC (datetime
) -
rounds (object
) -
groups (object
) -
id (integer
) - The FastPath-assigned ID of the competiton category
name (string
) - Name of the competition category. Example: Men
, Women
id (string
) - The FastPath-assigned id of the venue. Example: 665e9df6-4587-41b4-9a75-085e56e8579b
name (string
) - Descriptive name of the venue. Example: Drive in Arena
location (Location
) - Geographic location of the venue. Usually it is the city, country and continent. Example: Tel Aviv
, Israel
, Asia
name (string
) - Name of the venue. Example: Tel Aviv
country (Country
) - List of countries where the fixture is played out. Example: Israel
continent (Continent
) - List of continents where the fixture is played out. Example: Asia
name (string
) - Name of the country where the fixture plays out
name (string
) - Name of the continent where the fixture plays out
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