Fixtures

List all fixtures.

The Fixtures API lets developers list and manage competition fixtures of a specific season for which a client is licensed. This is a gateway into the Actions API and allows clients to determine which fixtures are live and available.

Applications don't need any input to list all fixtures, however information can be filtered by start date and end date among others. fixtures for which a client is licensed.

Per each competition, the endpoints 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)

Endpoints

List fixtures

GET https://dde-api.data.imgarena.com/v2/volleyball/fixtures

Retrieves a list of seasons for a specific sport.

Path Parameters

Name

Type

Description

sport*

String

volleyball

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
}

{
  "content": [
    {
      "id": "9758c833-c040-4458-9ea6-7d35e9ab0810",
      "name": "Odense Volleyball v Nordenskov UIF",
      "status": "Scheduled",
      "collectionStatus": "CollectionScheduled",
      "type": "Official",
      "coverageLevel": "In Venue",
      "startDateUTC": "2025-02-23T16:00:00",
      "teams": [
        {
          "id": "978a1105-f650-4975-a183-9df9387cd7fc",
          "name": "Odense Volleyball",
          "club": {
            "id": "04678be3-8930-462c-a044-77add8a5ce2e",
            "name": "ODENSE VOLLEYBALL"
          },
          "category": {
            "id": 1,
            "name": "Men"
          },
          "homeTeam": true
        },
        {
          "id": "921c718e-8c91-4428-b8bb-9fe16447f0c6",
          "name": "Nordenskov UIF",
          "club": {
            "id": "b9fd47a2-400b-496b-8bc7-34b7bf3aff81",
            "name": "NORDENSKOV UIF"
          },
          "category": {
            "id": 1,
            "name": "Men"
          },
          "homeTeam": false
        }
      ],
      "stage": {
        "id": "48726135-13d2-466e-9978-1c7886fa16a4",
        "name": "Regular round",
        "season": {
          "id": "988e515b-bb9d-4e8d-849b-e1ce6a7224b1",
          "name": "2024/2025",
          "startDateUTC": "2024-09-26T12:00:00",
          "endDateUTC": "2025-02-28T12:00:00",
          "competition": {
            "id": "f39557e0-63a2-44e7-8cf2-ff7521ed874a",
            "name": "Denmark Volleyligaen",
            "type": "Official",
            "category": {
              "id": 1,
              "name": "Men"
            },
            "tour": {
              "id": 265,
              "name": "CSM"
            },
            "location": {
              "name": "Denmark",
              "country": {},
              "continent": {
                "name": "Europe"
              }
            },
            "latestComment": "Coverage level change - Now to CL1 (In Venue) - REASONING: Please disregard it's an old match. . Volleyball - Denmark Volleyligaen - 2024 - Gentofte v Vestsjaelland - ID: 5506e863-3ccc-44e0-90d1-5b3f159f1712. Fixture Start Date and Time: 2024-04-22 17:00:00 UTC",
            "commentCount": 101
          },
          "sport": "Volleyball"
        },
        "startDateUTC": "2024-09-26T12:00:00",
        "endDateUTC": "2025-02-28T12:00:00"
      },
      "venue": {
        "id": "3cf07ef6-b5a2-4a34-8de7-9b86c43a350f",
        "name": "Klostermarkshallen",
        "location": {
          "name": "Odense C",
          "country": {
            "name": "Denmark"
          },
          "continent": {
            "name": "Europe"
          }
        }
      },
      "sport": "Volleyball",
      "fixtureDeleted": false
    },
    {
      "id": "7a186c96-7ac1-4bce-8731-d55a9f389ff5",
      "name": "Holstebro W v Brondby W",
      "status": "Scheduled",
      "collectionStatus": "CollectionScheduled",
      "type": "Official",
      "coverageLevel": "In Venue",
      "startDateUTC": "2025-02-23T14:00:00",
      "teams": [
        {
          "id": "c9157331-06f9-49c3-b947-138925ee0119",
          "name": "Holstebro W",
          "club": {
            "id": "1da8a044-3476-45db-bdfa-40eaae55aa4a",
            "name": "HOLSTEBRO W"
          },
          "category": {
            "id": 2,
            "name": "Women"
          },
          "homeTeam": true
        },
        {
          "id": "d79867eb-97f5-4c02-ad54-a9981f552885",
          "name": "Brondby W",
          "club": {
            "id": "b5a5ee1c-0ee1-4b2f-8078-91d193f11cc1",
            "name": "BRONDBY W"
          },
          "category": {
            "id": 2,
            "name": "Women"
          },
          "homeTeam": false
        }
      ],
      "stage": {
        "id": "8f3e4f6d-1cfd-4d1b-bad3-cda4caa1f7a5",
        "name": "Regular Round",
        "season": {
          "id": "64bf2fb5-8313-461e-925f-8686ba4eef5c",
          "name": "2024/2025",
          "startDateUTC": "2024-09-26T12:00:00",
          "endDateUTC": "2025-02-28T12:00:00",
          "competition": {
            "id": "675100ed-c40a-4354-9075-d5d3b8f8b2dc",
            "name": "Denmark Volleyligaen Women",
            "type": "Official",
            "category": {
              "id": 2,
              "name": "Women"
            },
            "tour": {
              "id": 265,
              "name": "CSM"
            },
            "location": {
              "name": "Denmark",
              "country": {},
              "continent": {
                "name": "Europe"
              }
            },
            "latestComment": "Collection status change - Collecting Live - REASONING: Connectivity issue has been resolved. Volleyball - Denmark Volleyligaen Women - 2024 - Holte W v ASV Elite W - ID: 92ff089a-e9ff-4cb9-8a25-86823ced6eaa. Fixture Start Date and Time: 2024-04-21 12:00:00 UTC",
            "commentCount": 65
          },
          "sport": "Volleyball"
        },
        "startDateUTC": "2024-09-26T12:00:00",
        "endDateUTC": "2025-02-28T12:00:00"
      },
      "venue": {
        "id": "ef8780e6-5b9e-4dbc-b7f7-ffb82f15a622",
        "name": "Holstebro Stadionhal",
        "location": {
          "name": "Holstebro",
          "country": {
            "name": "Denmark"
          },
          "continent": {
            "name": "Europe"
          }
        }
      },
      "sport": "Volleyball",
      "fixtureDeleted": false
    }
  ],
  "pageable": {
    "pageNumber": 0,
    "pageSize": 20,
    "sort": {
      "empty": false,
      "sorted": true,
      "unsorted": false
    },
    "offset": 0,
    "paged": true,
    "unpaged": false
  },
  "last": false,
  "totalPages": 454,
  "totalElements": 9067,
  "size": 20,
  "number": 0,
  "sort": {
    "empty": false,
    "sorted": true,
    "unsorted": false
  },
  "first": true,
  "numberOfElements": 20,
  "empty": false
}

List season fixtures

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

Path Parameters

Name

Type

Description

sport*

String

volleyball

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.

{
  "content": [
    {
      "id": "9758c833-c040-4458-9ea6-7d35e9ab0810",
      "name": "Odense Volleyball v Nordenskov UIF",
      "status": "Scheduled",
      "collectionStatus": "CollectionScheduled",
      "type": "Official",
      "coverageLevel": "In Venue",
      "startDateUTC": "2025-02-23T16:00:00",
      "teams": [
        {
          "id": "978a1105-f650-4975-a183-9df9387cd7fc",
          "name": "Odense Volleyball",
          "club": {
            "id": "04678be3-8930-462c-a044-77add8a5ce2e",
            "name": "ODENSE VOLLEYBALL"
          },
          "category": {
            "id": 1,
            "name": "Men"
          },
          "homeTeam": true
        },
        {
          "id": "921c718e-8c91-4428-b8bb-9fe16447f0c6",
          "name": "Nordenskov UIF",
          "club": {
            "id": "b9fd47a2-400b-496b-8bc7-34b7bf3aff81",
            "name": "NORDENSKOV UIF"
          },
          "category": {
            "id": 1,
            "name": "Men"
          },
          "homeTeam": false
        }
      ],
      "stage": {
        "id": "48726135-13d2-466e-9978-1c7886fa16a4",
        "name": "Regular round",
        "season": {
          "id": "988e515b-bb9d-4e8d-849b-e1ce6a7224b1",
          "name": "2024/2025",
          "startDateUTC": "2024-09-26T12:00:00",
          "endDateUTC": "2025-02-28T12:00:00",
          "competition": {
            "id": "f39557e0-63a2-44e7-8cf2-ff7521ed874a",
            "name": "Denmark Volleyligaen",
            "type": "Official",
            "category": {
              "id": 1,
              "name": "Men"
            },
            "tour": {
              "id": 265,
              "name": "CSM"
            },
            "location": {
              "name": "Denmark",
              "country": {},
              "continent": {
                "name": "Europe"
              }
            },
            "latestComment": "Coverage level change - Now to CL1 (In Venue) - REASONING: Please disregard it's an old match. . Volleyball - Denmark Volleyligaen - 2024 - Gentofte v Vestsjaelland - ID: 5506e863-3ccc-44e0-90d1-5b3f159f1712. Fixture Start Date and Time: 2024-04-22 17:00:00 UTC",
            "commentCount": 101
          },
          "sport": "Volleyball"
        },
        "startDateUTC": "2024-09-26T12:00:00",
        "endDateUTC": "2025-02-28T12:00:00"
      },
      "venue": {
        "id": "3cf07ef6-b5a2-4a34-8de7-9b86c43a350f",
        "name": "Klostermarkshallen",
        "location": {
          "name": "Odense C",
          "country": {
            "name": "Denmark"
          },
          "continent": {
            "name": "Europe"
          }
        }
      },
      "sport": "Volleyball",
      "fixtureDeleted": false
    },
    {
      "id": "12330eae-1ea4-42d9-92f3-bd94d8dd776a",
      "name": "Amager v DHV Odense",
      "status": "Scheduled",
      "collectionStatus": "CollectionScheduled",
      "type": "Official",
      "coverageLevel": "In Venue",
      "startDateUTC": "2025-02-22T16:00:00",
      "teams": [
        {
          "id": "6ebfcbee-224f-4cac-8ade-0819e7801397",
          "name": "Amager",
          "club": {
            "id": "e68a13b1-2cfd-4252-a5fc-cc959e09de72",
            "name": "AMAGER"
          },
          "category": {
            "id": 1,
            "name": "Men"
          },
          "homeTeam": true
        },
        {
          "id": "2463452c-ee62-4848-8551-76ae7928e978",
          "name": "DHV Odense",
          "club": {
            "id": "062697e2-5b9a-4b5e-9a53-b63568bb02f4",
            "name": "DHV ODENSE"
          },
          "category": {
            "id": 1,
            "name": "Men"
          },
          "homeTeam": false
        }
      ],
      "stage": {
        "id": "48726135-13d2-466e-9978-1c7886fa16a4",
        "name": "Regular round",
        "season": {
          "id": "988e515b-bb9d-4e8d-849b-e1ce6a7224b1",
          "name": "2024/2025",
          "startDateUTC": "2024-09-26T12:00:00",
          "endDateUTC": "2025-02-28T12:00:00",
          "competition": {
            "id": "f39557e0-63a2-44e7-8cf2-ff7521ed874a",
            "name": "Denmark Volleyligaen",
            "type": "Official",
            "category": {
              "id": 1,
              "name": "Men"
            },
            "tour": {
              "id": 265,
              "name": "CSM"
            },
            "location": {
              "name": "Denmark",
              "country": {},
              "continent": {
                "name": "Europe"
              }
            },
            "latestComment": "Coverage level change - Now to CL1 (In Venue) - REASONING: Please disregard it's an old match. . Volleyball - Denmark Volleyligaen - 2024 - Gentofte v Vestsjaelland - ID: 5506e863-3ccc-44e0-90d1-5b3f159f1712. Fixture Start Date and Time: 2024-04-22 17:00:00 UTC",
            "commentCount": 101
          },
          "sport": "Volleyball"
        },
        "startDateUTC": "2024-09-26T12:00:00",
        "endDateUTC": "2025-02-28T12:00:00"
      },
      "venue": {
        "id": "7eca6cd3-f3b1-4611-a15e-02ef77ff6d50",
        "name": "Sundby hallen",
        "location": {
          "name": "Kobenhavn O",
          "country": {
            "name": "Denmark"
          },
          "continent": {
            "name": "Europe"
          }
        }
      },
      "sport": "Volleyball",
      "fixtureDeleted": false
    }
  ],
  "pageable": {
    "pageNumber": 0,
    "pageSize": 20,
    "sort": {
      "empty": false,
      "unsorted": false,
      "sorted": true
    },
    "offset": 0,
    "paged": true,
    "unpaged": false
  },
  "last": false,
  "totalPages": 5,
  "totalElements": 90,
  "size": 20,
  "number": 0,
  "sort": {
    "empty": false,
    "unsorted": false,
    "sorted": true
  },
  "first": true,
  "numberOfElements": 20,
  "empty": false
}

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

Get fixture

GET https://dde-api.data.imgarena.com/v2/volleyball/fixtures/{fixtureId}

Path Parameters

Name

Type

Description

sport*

String

volleyball

fixtureId*

UUID

Unique id of a requested fixture.

```json
{
    "id": "9758c833-c040-4458-9ea6-7d35e9ab0810",
    "name": "Odense Volleyball v Nordenskov UIF",
    "status": "Scheduled",
    "collectionStatus": "CollectionScheduled",
    "type": "Official",
    "coverageLevel": "In Venue",
    "startDateUTC": "2025-02-23T16:00:00",
    "teams": [
        {
            "id": "978a1105-f650-4975-a183-9df9387cd7fc",
            "name": "Odense Volleyball",
            "club": {
                "id": "04678be3-8930-462c-a044-77add8a5ce2e",
                "name": "ODENSE VOLLEYBALL"
            },
            "category": {
                "id": 1,
                "name": "Men"
            },
            "homeTeam": true
        },
        {
            "id": "921c718e-8c91-4428-b8bb-9fe16447f0c6",
            "name": "Nordenskov UIF",
            "club": {
                "id": "b9fd47a2-400b-496b-8bc7-34b7bf3aff81",
                "name": "NORDENSKOV UIF"
            },
            "category": {
                "id": 1,
                "name": "Men"
            },
            "homeTeam": false
        }
    ],
    "stage": {
        "id": "48726135-13d2-466e-9978-1c7886fa16a4",
        "name": "Regular round",
        "season": {
            "id": "988e515b-bb9d-4e8d-849b-e1ce6a7224b1",
            "name": "2024/2025",
            "startDateUTC": "2024-09-26T12:00:00",
            "endDateUTC": "2025-02-28T12:00:00",
            "competition": {
                "id": "f39557e0-63a2-44e7-8cf2-ff7521ed874a",
                "name": "Denmark Volleyligaen",
                "type": "Official",
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "tour": {
                    "id": 265,
                    "name": "CSM"
                },
                "location": {
                    "name": "Denmark",
                    "country": {},
                    "continent": {
                        "name": "Europe"
                    }
                },
                "latestComment": "Coverage level change - Now to CL1 (In Venue) - REASONING: Please disregard it's an old match. . Volleyball - Denmark Volleyligaen - 2024 - Gentofte v Vestsjaelland - ID: 5506e863-3ccc-44e0-90d1-5b3f159f1712. Fixture Start Date and Time: 2024-04-22 17:00:00 UTC",
                "commentCount": 101
            },
            "sport": "Volleyball"
        },
        "startDateUTC": "2024-09-26T12:00:00",
        "endDateUTC": "2025-02-28T12:00:00"
    },
    "venue": {
        "id": "3cf07ef6-b5a2-4a34-8de7-9b86c43a350f",
        "name": "Klostermarkshallen",
        "location": {
            "name": "Odense C",
            "country": {
                "name": "Denmark"
            },
            "continent": {
                "name": "Europe"
            }
        }
    },
    "sport": "Volleyball",
    "fixtureDeleted": false
}
```

{
    Request is missing required HTTP header 'Accept'
}

{
    The supplied authentication is invalid
}

Response fields

fixture

The requested list of fixtures or a single fixture.

Efficient Polling

Although not real-time, API polling involves the repetitive transmission of client requests to an endpoint for the purpose of identifying changes in information. To maintain optimal performance for all customers, our API implements rate limits.We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times.

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.

Pagination

Please find the following link to the pagination page.

We kindly request your thorough perusal of this section in order to familiarize yourself with forthcoming alterations scheduled for implementation on the 31st of July, 2023.

These modifications, primarily encompassing the introduction of supplementary parameters, are anticipated to be of a straightforward nature and aim to enhance the query efficiency of our Fixtures API, thereby affording you considerable advantages.

PreviousSeasons NextSquads

Last updated 2 months ago