Fixtures

List and manage competition fixtures for specific seasons under their client license.

The Fixtures API provides endpoints for accessing detailed fixture data, encompassing specific match dates, team matchups, and vital event information. This API presents various filtering options, allowing users to customise their searches based on particular matches, teams, or periods. This documentation aims to facilitate the integration of sports fixture data into applications, thereby enriching and contextualising sports-related content.

Endpoints

List all fixtures

GET https://dde-api.data.imgarena.com/ice-hockey/fixtures

Retrieves a list of seasons for a specific sport.

Query Parameters

Name Type Description

Name	Type	Description
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`
coverageLevel	String	The coverage level of a fixture. Examples: `noCoverage`, `inVenue`, `lowLatencyStream`, `standardStre`am & `video(postmatch)`
sort	String	Assortment of the data within the fixtures API. We currently support `name`, `asc`, `desc` and `startTime`. Sort should be supplied in the form `sort=<field>,<direction>` where direction defaults to `asc` if not supplied. If wanting to sort by multiple fields then the sort parameter should be supplied for each field in the order the sort is desired. Default sort order is by startTime and name.
size	Integer	The page size. Default is 20 fixtures. Please be sensible specifying the size to ensure the most efficient results and API performance
page	Integer	The page number

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

coverageLevel

String

The coverage level of a fixture. Examples: noCoverage, inVenue, lowLatencyStream, standardStream & video(postmatch)

sort

String

Assortment of the data within the fixtures API. We currently support name, asc, desc and startTime.

Sort should be supplied in the form `sort=<field>,<direction>` where direction defaults to `asc` if not supplied.

If wanting to sort by multiple fields then the sort parameter should be supplied for each field in the order the sort is desired.

Default sort order is by startTime and name.

size

Integer

The page size. Default is 20 fixtures. Please be sensible specifying the size to ensure the most efficient results and API performance

page

Integer

The page number

Headers

Name	Type	Description
Accept*	String	application/vnd.imggaming.dde.api+json;version=1
Authorization*	String	Bearer ACCESS_TOKEN
Content-Type*	String	application/json

Name

Type

Description

Accept*

String

application/vnd.imggaming.dde.api+json;version=1

Authorization*

String

Bearer ACCESS_TOKEN

Content-Type*

String

application/json

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

{
  "id": "2ffbf044-db53-43ea-9898-a43868ca014d",
  "name": "BC Lietkabelis Panevezys v Jonava BC Cbet",
  "status": "Scheduled",
  "type": "Official",
  "coverageLevel": "In Venue",
  "startDateUTC": "2023-01-07T15:00:00",
  "teams": [
    {
      "id": "f14fd931-a113-4a0b-9c5c-532057c96301",
      "name": "Jonava BC Cbet",
      "club": {
        "id": "b6c236e8-b9df-4a65-ae01-932864572b93",
        "name": "JONAVA BC CBET"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": false
    },
    {
      "id": "b184558c-d9dd-4ada-898d-520b3d387622",
      "name": "BC Lietkabelis Panevezys",
      "club": {
        "id": "bda8ed69-da63-434e-8b79-a20980f32c2e",
        "name": "BC LIETKABELIS PANEVEZYS"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": true
    }
  ],
  "stage": {
    "id": "96afe2dd-58e7-435d-a9f9-999d64ec8b86",
    "name": "Regular round",
    "season": {
      "id": "7ac2140e-dd57-404a-bc3a-54d7fcd97343",
      "name": "Season 2022/2023",
      "startDateUTC": "2022-09-24T12:00:00",
      "endDateUTC": "2023-05-31T12:00:00",
      "competition": {
        "id": "5c50bf20-7b5e-4d19-b2fe-aa1d20a042b2",
        "name": "Lithuania LKL",
        "category": {
          "id": 1,
          "name": "Men"
        },
        "tour": {
          "id": 45,
          "name": "Lithuanian Basketball Federation (LKF)"
        },
        "location": {
          "name": "Lithuania",
          "country": {},
          "continent": {
            "name": "Europe"
          }
        }
      }
    },
    "startDateUTC": "2022-09-24T12:00:00",
    "endDateUTC": "2023-05-31T12:00:00"
  },
  "venue": {
    "id": "7d30af55-89e2-4b50-a107-db133dcb3730",
    "name": "Cido Arena",
    "location": {
      "name": "Panevezys",
      "country": {
        "name": "Lithuania"
      },
      "continent": {
        "name": "Europe"
      }
    }
  },
  "fixtureDeleted": false
}

List season fixtures

GET https://dde-api.data.imgarena.com/ice-hockey/seasons/{seasonId}/fixtures

Path Parameters

Name	Type	Description
seasonId*	UUID	unique id of a requested season

Name

Type

Description

seasonId*

UUID

unique id of a requested season

Query Parameters

Name Type Description

Name	Type	Description
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`
sort	String	Assortment of the data within the fixtures API. We currently support `name`, `asc`, `desc` and `startTime` Sort should be supplied in the form `sort=<field>,<direction>` where direction defaults to `asc` if not supplied. If wanting to sort by multiple fields then the sort parameter should be supplied for each field in the order the sort is desired. Default sort order is by startTime and name.
size	Integer	The page size. Default is 20 fixtures. Please be sensible specifying the size to ensure the most efficient results and API performance
page	Integer	The page number
coverageLevel	String	The coverage level of a fixture. Examples: `noCoverage`, `inVenue`, `lowLatencyStream`, `standardStre`am & `video(postmatch)`

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

sort

String

Assortment of the data within the fixtures API. We currently support name, asc, desc and startTime Sort should be supplied in the form `sort=<field>,<direction>` where direction defaults to `asc` if not supplied.

If wanting to sort by multiple fields then the sort parameter should be supplied for each field in the order the sort is desired.

Default sort order is by startTime and name.

size

Integer

The page size. Default is 20 fixtures. Please be sensible specifying the size to ensure the most efficient results and API performance

page

Integer

The page number

coverageLevel

String

The coverage level of a fixture. Examples: noCoverage, inVenue, lowLatencyStream, standardStream & video(postmatch)

{
  "id": "2ffbf044-db53-43ea-9898-a43868ca014d",
  "name": "BC Lietkabelis Panevezys v Jonava BC Cbet",
  "status": "Scheduled",
  "type": "Official",
  "coverageLevel": "In Venue",
  "startDateUTC": "2023-01-07T15:00:00",
  "teams": [
    {
      "id": "f14fd931-a113-4a0b-9c5c-532057c96301",
      "name": "Jonava BC Cbet",
      "club": {
        "id": "b6c236e8-b9df-4a65-ae01-932864572b93",
        "name": "JONAVA BC CBET"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": false
    },
    {
      "id": "b184558c-d9dd-4ada-898d-520b3d387622",
      "name": "BC Lietkabelis Panevezys",
      "club": {
        "id": "bda8ed69-da63-434e-8b79-a20980f32c2e",
        "name": "BC LIETKABELIS PANEVEZYS"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": true
    }
  ],
  "stage": {
    "id": "96afe2dd-58e7-435d-a9f9-999d64ec8b86",
    "name": "Regular round",
    "season": {
      "id": "7ac2140e-dd57-404a-bc3a-54d7fcd97343",
      "name": "Season 2022/2023",
      "startDateUTC": "2022-09-24T12:00:00",
      "endDateUTC": "2023-05-31T12:00:00",
      "competition": {
        "id": "5c50bf20-7b5e-4d19-b2fe-aa1d20a042b2",
        "name": "Lithuania LKL",
        "category": {
          "id": 1,
          "name": "Men"
        },
        "tour": {
          "id": 45,
          "name": "Lithuanian Basketball Federation (LKF)"
        },
        "location": {
          "name": "Lithuania",
          "country": {},
          "continent": {
            "name": "Europe"
          }
        }
      }
    },
    "startDateUTC": "2022-09-24T12:00:00",
    "endDateUTC": "2023-05-31T12:00:00"
  },
  "venue": {
    "id": "7d30af55-89e2-4b50-a107-db133dcb3730",
    "name": "Cido Arena",
    "location": {
      "name": "Panevezys",
      "country": {
        "name": "Lithuania"
      },
      "continent": {
        "name": "Europe"
      }
    }
  },
  "fixtureDeleted": false
}

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

List specific fixture

GET https://dde-api.data.imgarena.com/ice-hockey/fixtures/{fixtureId}

Path Parameters

Name	Type	Description
fixtureId*	UUID	Unique id of a requested fixture.

Name

Type

Description

fixtureId*

UUID

Unique id of a requested fixture.

{
  "id": "2ffbf044-db53-43ea-9898-a43868ca014d",
  "name": "BC Lietkabelis Panevezys v Jonava BC Cbet",
  "status": "Scheduled",
  "type": "Official",
  "coverageLevel": "In Venue",
  "startDateUTC": "2023-01-07T15:00:00",
  "teams": [
    {
      "id": "f14fd931-a113-4a0b-9c5c-532057c96301",
      "name": "Jonava BC Cbet",
      "club": {
        "id": "b6c236e8-b9df-4a65-ae01-932864572b93",
        "name": "JONAVA BC CBET"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": false
    },
    {
      "id": "b184558c-d9dd-4ada-898d-520b3d387622",
      "name": "BC Lietkabelis Panevezys",
      "club": {
        "id": "bda8ed69-da63-434e-8b79-a20980f32c2e",
        "name": "BC LIETKABELIS PANEVEZYS"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": true
    }
  ],
  "stage": {
    "id": "96afe2dd-58e7-435d-a9f9-999d64ec8b86",
    "name": "Regular round",
    "season": {
      "id": "7ac2140e-dd57-404a-bc3a-54d7fcd97343",
      "name": "Season 2022/2023",
      "startDateUTC": "2022-09-24T12:00:00",
      "endDateUTC": "2023-05-31T12:00:00",
      "competition": {
        "id": "5c50bf20-7b5e-4d19-b2fe-aa1d20a042b2",
        "name": "Lithuania LKL",
        "category": {
          "id": 1,
          "name": "Men"
        },
        "tour": {
          "id": 45,
          "name": "Lithuanian Basketball Federation (LKF)"
        },
        "location": {
          "name": "Lithuania",
          "country": {},
          "continent": {
            "name": "Europe"
          }
        }
      }
    },
    "startDateUTC": "2022-09-24T12:00:00",
    "endDateUTC": "2023-05-31T12:00:00"
  },
  "venue": {
    "id": "7d30af55-89e2-4b50-a107-db133dcb3730",
    "name": "Cido Arena",
    "location": {
      "name": "Panevezys",
      "country": {
        "name": "Lithuania"
      },
      "continent": {
        "name": "Europe"
      }
    }
  },
  "fixtureDeleted": false
}

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

Response object

Response object	Response type	Description
fixture	Fixture	The requested list of fixtures or a single fixture.

Response type

Description

fixture

Fixture

The requested list of fixtures or a single fixture.

Rate limits

Rate Limit	Notes
All fixtures	Tier 1
Live fixtures	Tier 3
Live upcoming fixtures	Tier 4

Rate Limit

Notes

All fixtures

Tier 1

Live fixtures

Tier 3

Live upcoming fixtures

Tier 4

PreviousSeasons NextSquads

Last updated 2 months ago