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/american-football/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'
}

List season fixtures

GET https://dde-api.data.imgarena.com/american-football/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)

includeDelete

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": "ffc47dc5-61e1-44e9-add7-6088c415aa42",
  "name": "Hapoel Tel Aviv v Ironi Kiryat Ata",
  "status": "Completed",
  "type": "Official",
  "coverageLevel": "In Venue",
  "startDateUTC": "2022-09-19T17:00:00",
  "teams": [
    {
      "id": "114aa40d-6895-48b9-9bfe-0abecc9d10c9",
      "name": "Hapoel Tel Aviv",
      "club": {
        "id": "3bf65514-d1b3-4768-8119-cee69b574734",
        "name": "HAPOEL TEL AVIV"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": true
    },
    {
      "id": "d4407cea-1880-4afa-8aa6-9c58b2d583f4",
      "name": "Ironi Kiryat Ata",
      "club": {
        "id": "da2da316-8876-4939-873b-d4ce5bff3688",
        "name": "IRONI KIRYAT ATA"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": false
    }
  ],
  "stage": {
    "id": "7eb6159c-94bf-45bd-a52d-4143fdbe47d0",
    "name": "Regular round",
    "season": {
      "id": "c7e3e6b7-e24f-4e76-8247-6d4626d17935",
      "name": "Season 2022/2023",
      "startDateUTC": "2022-09-19T12:00:00",
      "endDateUTC": "2023-05-31T12:00:00",
      "competition": {
        "id": "7d6aeba6-2599-4231-a0f9-fd218f38bced",
        "name": "Israel League Cup",
        "category": {
          "id": 1,
          "name": "Men"
        },
        "tour": {
          "id": 37,
          "name": "Israeli Basketball Association (IBBA)"
        },
        "location": {
          "name": "Israel",
          "country": {},
          "continent": {
            "name": "Asia"
          }
        }
      }
    },
    "startDateUTC": "2022-11-01T12:00:00",
    "endDateUTC": "2023-05-31T12:00:00"
  },
  "venue": {
    "id": "665e9df6-4587-41b4-9a75-085e56e8579b",
    "name": "Drive in Arena",
    "location": {
      "name": "Tel Aviv",
      "country": {
        "name": "Israel"
      },
      "continent": {
        "name": "Asia"
      }
    }
  },
   "fixtureDeleted": false
}

List specific fixture

GET https://dde-api.data.imgarena.com/american-football/fixtures/{fixtureId}

Path Parameters

Name
Type
Description

fixtureId*

UUID

Unique id of a requested fixture. 

{
  "id": "ffc47dc5-61e1-44e9-add7-6088c415aa42",
  "name": "Hapoel Tel Aviv v Ironi Kiryat Ata",
  "status": "Completed",
  "type": "Official",
  "coverageLevel": "In Venue",
  "startDateUTC": "2022-09-19T17:00:00",
  "teams": [
    {
      "id": "114aa40d-6895-48b9-9bfe-0abecc9d10c9",
      "name": "Hapoel Tel Aviv",
      "club": {
        "id": "3bf65514-d1b3-4768-8119-cee69b574734",
        "name": "HAPOEL TEL AVIV"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": true
    },
    {
      "id": "d4407cea-1880-4afa-8aa6-9c58b2d583f4",
      "name": "Ironi Kiryat Ata",
      "club": {
        "id": "da2da316-8876-4939-873b-d4ce5bff3688",
        "name": "IRONI KIRYAT ATA"
      },
      "category": {
        "id": 1,
        "name": "Men"
      },
      "homeTeam": false
    }
  ],
  "stage": {
    "id": "7eb6159c-94bf-45bd-a52d-4143fdbe47d0",
    "name": "Regular round",
    "season": {
      "id": "c7e3e6b7-e24f-4e76-8247-6d4626d17935",
      "name": "Season 2022/2023",
      "startDateUTC": "2022-09-19T12:00:00",
      "endDateUTC": "2023-05-31T12:00:00",
      "competition": {
        "id": "7d6aeba6-2599-4231-a0f9-fd218f38bced",
        "name": "Israel League Cup",
        "category": {
          "id": 1,
          "name": "Men"
        },
        "tour": {
          "id": 37,
          "name": "Israeli Basketball Association (IBBA)"
        },
        "location": {
          "name": "Israel",
          "country": {},
          "continent": {
            "name": "Asia"
          }
        }
      }
    },
    "startDateUTC": "2022-11-01T12:00:00",
    "endDateUTC": "2023-05-31T12:00:00"
  },
  "venue": {
    "id": "665e9df6-4587-41b4-9a75-085e56e8579b",
    "name": "Drive in Arena",
    "location": {
      "name": "Tel Aviv",
      "country": {
        "name": "Israel"
      },
      "continent": {
        "name": "Asia"
      }
    }
  },
   "fixtureDeleted": false
}

Response object

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

Last updated