# Конечная точка файткардов

## URL-адреса конечных точек

**Все турниры:**

| `https://dde-api.data.imgarena.com/mma/fightcards` |
| -------------------------------------------------- |

**Если вы хотите просмотреть только информацию по конкретному файткарду:**

| `https://dde-api.data.imgarena.com/mma/fightcards/{id}` |
| ------------------------------------------------------- |
|                                                         |

**Обязательные заголовки**

| Ключевой параметр | Значение                                        |
| ----------------- | ----------------------------------------------- |
| Accept            | application/vnd.imgarena.dde.api+json;version=1 |
| Content-Type      | application/json                                |
| Authorization     | Bearer eyvhaoudfgpdfgo\*                        |

\
**Параметры запроса**

Если направить запрос на данную конечную точку с одновременным указанием параметров «dateFrom» и «dateTo», то в овтет будут получены данные только по файткардам, входящим в пределы определенного диапазона дат. Оба параметра должны представлять собой дату в формате `YYYY-mm-dd`.

## Модель ответа

### **Объект** «**турнир**»

| **Имя поля**              | **Тип**     | **Описание**                                                                                                        |
| ------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------- |
| fightcardName             | строка      | название файткарда                                                                                                  |
| identifier                | целое число | идентификатор файткарда                                                                                             |
| countryCode               | строка      | код страны, в которой проходит файткард                                                                             |
| location                  | строка      | страна, в которой проходит файткард                                                                                 |
| state                     | строка      | штат/провинция, где проходит файткард                                                                               |
| city                      | строка      | город, в котором проходит файткард                                                                                  |
| venue                     | строка      | название места, в котором проходит файткард                                                                         |
| venueId                   | целое число | идентификатор места, в котором проходит файткард                                                                    |
| startDate                 | дата        | дата начала файткарда                                                                                               |
| endDate                   | дата        | дата окончания файткарда                                                                                            |
| startTime                 | время       | время, когда стартует файткард, в формате местного времени + смещение от всемирного координированного времени (UTC) |
| utcOffset                 | целое число | смещение от UTC часового пояса, в котором проходит файткард                                                         |
| year                      | целое число | год, в котором проходит файткард                                                                                    |
| sport                     | строка      | вид спорта, связанный с файткардом, в данном случае ММА                                                             |
| numberOfFights            | целое число | количество боев по файткарду                                                                                        |
| scheduleResource          | строка      | ссылка на URL-адрес API, по которому доступно расписание данного файткарда                                          |
| status                    | строка      | <p>статус данного файткарда.</p><p>Возможные значения: «active» / «canceled».</p>                                   |
| booking Status            | объект      | информация о том, забронирован ли файткард                                                                          |
| comments                  | массив      | последние комментарии к статусу файткарда                                                                           |
| numberOfFightsBookedToday | целое число | количество боев, забронированных с помощью функции DDE в соответствии с вашим лицензионным соглашением              |
| eventSummary              | объект      | сводные данные по предварительным и основным кардам, т.е., начало и количество боев                                 |
| attendance                | целое число | общее число присутствующих болельщиков                                                                              |
| competitions              | массив      | -                                                                                                                   |

### **Объект** «**Сводные данные по боям**»

Каждый файткард будет разбит на три карда; «main», «prelims1» и «prelims 2». Данный объект будет сообщать дату боя и три указанных карда.

| Имя поля  | Тип         | Описание                                              |
| --------- | ----------- | ----------------------------------------------------- |
| fights    | целое число | количество боев в данном конкретном файткарде         |
| startTime | время       | предполагаемое время старта данного конкретного карда |

### **Объект** «**Статус бронирования**»

| **И**мя поля | Тип    | Описание                                                      |
| ------------ | ------ | ------------------------------------------------------------- |
| status       | строка | Текущий статус бронирования мероприятия с помощью функции DDE |

### **Объект** «**Состязания**»

| Имя поля          | Тип    | Описание                                             |
| ----------------- | ------ | ---------------------------------------------------- |
| organisation      | строка | организация, проводящая данный конкретный файткард   |
| startDate         | дата   | дата начала файткарда                                |
| endDate           | дата   | дата завершения файткарда                            |
| licensingProperty | строка | DDE-объект, лицензирующий данный конкретный файткард |

### Образец ответа

```
{
    "city": "Las Vegas",
    "startTime": "22:00",
    "location": "USA",
    "endDate": "2022-09-10",
    "fightcardName": "UFC 279: Chimaev vs. Diaz",
    "state": "Nevada",
    "identifier": 758,
    "numberOfFightsBookedToday": 13,
    "year": 2022,
    "sport": "MMA",
    "venueId": "50",
    "scheduleResource": "/mma/fightcards/758/schedule",
    "countryCode": "USA",
    "status": "active",
    "numberOfFights": 13,
    "eventsSummary": {
        "2022-09-10": {
            "prelims1": {
                "fights": 4,
                "startTime": "00:00"
            },
            "prelims2": {
                "fights": 4,
                "startTime": "22:00"
            },
            "main": {
                "fights": 5,
                "startTime": "02:00"
            }
        }
    },
    "utcOffset": 0,
    "attendance": null,
    "startDate": "2022-09-10",
    "bookingStatus": {
        "status": "AutoBooked"
    },
    "venue": "T-Mobile Arena",
    "competitions": [
        {
            "organisation": "UFC",
            "startDate": "2022-09-10",
            "endDate": "2022-09-10"
        }
    ],
    "comments": []
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportradar.com/ufc-5.0/ufc-5.0-russian/building-static-data/fightcards-endpoint.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.