1 of 1

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

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

includeDeleted

Boolean

Pass "false" to exclude deleted fixtures from the response.

By default, this value is set to "true," meaning deleted fixtures will be included in the response.

Headers

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

Query Parameters

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, standardStream & video(postmatch)

includeDeleted

Boolean

Pass "false" to exclude deleted fixtures from the response.

By default, this value is set to "true," meaning deleted fixtures will be included in the response.

{
  "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.

{
  "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 type

Description

fixture

The requested list of fixtures or a single fixture.

Deleted fixtures

In some cases, fixtures may be deleted. To manage this, each fixture includes a "fixtureDeleted" flag. By default, this flag is set to "false." If the flag is set to "true," it indicates that the fixture has been deleted and should be disregarded.

Rate limits

Rate Limit

Notes

All fixtures

Live fixtures

Live upcoming fixtures

Fixtures

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

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

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

includeDeleted

Boolean

Pass "false" to exclude deleted fixtures from the response.

By default, this value is set to "true," meaning deleted fixtures will be included in the response.

Headers

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

Query Parameters

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

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)

includeDeleted

Boolean

Pass "false" to exclude deleted fixtures from the response.

By default, this value is set to "true," meaning deleted fixtures will be included in the response.

{
  "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.

{
  "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 type

Description

fixture

The requested list of fixtures or a single fixture.

Deleted fixtures

Rate limits

Rate Limit

Notes

All fixtures

Live fixtures

Live upcoming fixtures