# Fixtures (old)

This endpoint returns the competition fixtures for a specific season. Per each competition, this endpoint 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)

## Endpoint URLs

### Live Fixtures (Subscribed):

`https://dde-api.data.imgarena.com/basketball/fixtures?live=true&subscribed=true`

OR

`https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/fixtures?live=true&subscribed=true`

This allows clients to determine which fixtures are live and available based on a user's licence. The top URL shows all live fixtures and the bottom shows all live fixtures within that seasonId.

### **Fixtures (Subscribed):**

`https://dde-api.data.imgarena.com/basketball/fixtures?subscribed=true`

OR

`https://dde-api.data.imgarena.com/basketball/`seasons`/{seasonId}/fixtures?subscribed=true`

The top URL lists the fixtures for which you a user is licensed, and the bottom URL the fixtures within a specific seasonId, that a user is licensed for.

### **All Fixtures (Unsubscribed):**

`https://dde-api.data.`imgarena`.com/basketball/fixtures`<br>

OR

`https://dde-api.data.imgarena.com/basketball/seasons/`{`seasonId}/fixtures`

This top URL lists the fixtures for all competitions (licensed and unlicensed). This is useable for an operator to see what which competitions might be available to purchase from IMGA. The bottom URL is a list of fixtures for a specific seasonId, both licensed and unlicensed.

### **Single Fixture**

`https://dde-api.data.imgarena.com/basketball/fixtures/{fixtureId}`

This allows clients to determine the details for a single fixture

### **Status & dateTo and dateFrom**

`https://dde-api.data.imgarena.com/basketball/fixtures?subscribed=true&status=scheduled&dateFrom=2022-07-07&dateTo=2022-07-10`

This allows clients to filter based on the status of a match or group of matches and between specific dates. For example, the above URL would show all matches that are 'scheduled' that a client is a licensed for between 7th July 2022 and 10th July 2022. These additional parameters can be used in conjunction with other support parameters like ?live=true and also be utilised with seasonId to allow a user to filter by status and dateTo and dateFrom within a certain season.

Supported status values are 'scheduled', 'live', 'completed', 'postponed'

### Type

Type parameter allows a user to call the fixtures API by 'Official', 'Simulation' or 'Training'. Official will denote any official match collected by our data collection team, Simulation is generally any match we simulate and Training is for internal data collection training.

`https://dde-api.data.imgarena.com/basketball/fixtures?dateFrom=2022-09-01&dateTo=2022-09-30&type=official`

## Polling Frequency <a href="#undefined" id="undefined"></a>

We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:

| API                         | REST Endpoint                                                                                                                                                                | Frequency                                | Description                                                                                                                  |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Live Fixtures (Subscribed)  | <p><code>/basketball/fixtures?live=true\&subscribed=true</code><br><strong>OR</strong><br><code>basketball/seasons/{seasonId}/fixtures?live=true\&subscribed=true</code></p> | Every 30 seconds for a fixture           | Live fixtures for which a client is licensed. This allows clients to determine which fixtures are live and availabl&#x65;*.* |
| Fixtures (Subscribed)       | <p><code>/basketball/fixtures?subscribed=true</code><br><strong>OR</strong><br><code>/basketball/seasons/{seasonId}/fixtures?subscribed=true</code></p>                      | Every 60 seconds for an upcoming fixture | The fixtures for a competition for which a client is licensed.                                                               |
| All Fixtures (Unsubscribed) | <p><code>/basketball/fixtures</code></p><p><strong>OR</strong> <code>/basketball/seasons/{seasonId}/fixtures</code></p>                                                      | Every 24 hours                           | Lists ALL the fixtures for all competitions. This is useful to determine what IMGA covers for that sport.                    |

## Required Headers

| Key           | Value                                            |
| ------------- | ------------------------------------------------ |
| Accept        | application/vnd.imggaming.dde.api+json;version=1 |
| Content-Type  | application/json                                 |
| Authorization | Bearer eyvhaoudfgpdfgo\*                         |

##

## Response Model

For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:

JSON Schema - <https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/get_basketball_fixtures>

<https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/getFixturesBySeasonId>

JSON Schema with value descriptions - <https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/Fixture>