# Punto final de Carteleras

## URL de punto final

**Para todos los torneos:**

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

**Si desea ver solo la información de una cartelera en particular:**

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

**Encabezados requeridos**

| Clave          | Valor                                           |
| -------------- | ----------------------------------------------- |
| Aceptar        | application/vnd.imgarena.dde.api+json;version=1 |
| Contenido-Tipo | application/json                                |
| Autorización   | Portador eyvhaoudfgpdfgo\*                      |

\
**Parámetros de solicitud**

El punto final se puede solicitar usando los parámetros dateFrom y dateTo juntos, para devolver solo las carteleras dentro de un cierto intervalo de fechas. Ambos parámetros deben especificar una fecha en formato `AAAA-mm-dd`.

## **Modelo de Respuesta**

### **Objeto Tournament**

| **Nombre de Campo**       | **Tipo**      | **Descripción**                                                                                             |
| ------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------- |
| fightcardName             | cadena        | El nombre de la cartelera.                                                                                  |
| identifier                | número entero | La identificación de la cartelera.                                                                          |
| countryCode               | cadena        | El código del país donde tiene lugar la cartelera.                                                          |
| location                  | cadena        | El país en el que tiene lugar la cartelera.                                                                 |
| state                     | cadena        | El estado/provincia en el que tiene lugar la cartelera.                                                     |
| city                      | cadena        | La ciudad en la que tiene lugar la cartelera.                                                               |
| venue                     | cadena        | El nombre del recinto donde tiene lugar la cartelera.                                                       |
| venueId                   | número entero | La ID del recinto donde tiene lugar la cartelera.                                                           |
| startDate                 | fecha         | La fecha de inicio de la cartelera.                                                                         |
| endDate                   | fecha         | La fecha de final de la cartelera.                                                                          |
| startTime                 | hora          | La hora en que comienza la cartelera, en formato de hora local + compensación UTC.                          |
| utcOffset                 | número entero | La compensación UTC de la zona horaria en el que tiene lugar la cartelera.                                  |
| year                      | número entero | El año en el que tiene lugar la cartelera.                                                                  |
| sport                     | cadena        | El deporte asociado con la cartelera, en este caso MMA.                                                     |
| numberOfFights            | número entero | El número de peleas en la cartelera.                                                                        |
| scheduleResource          | cadena        | Una referencia a la URL de la API para el horario de esta cartelera.                                        |
| status                    | cadena        | <p>El estado de esta cartelera.</p><p>Los valores potenciales son: active/cancelled (activa/cancelada).</p> |
| booking Status            | objeto        | Información sobre si una cartelera está reservada o no.                                                     |
| comments                  | despliegue    | Los últimos comentarios sobre el estado de la cartelera.                                                    |
| numberOfFightsBookedToday | número entero | Número de peleas reservadas en el DDE según su acuerdo de licencia.                                         |
| eventSummary              | objeto        | Resumen de carteleras preliminares y principales, es decir, el número de peleas y su inicio.                |
| attendance                | número entero | Asistentes totales al evento.                                                                               |
| competitions              | despliegue    | -                                                                                                           |

### Objeto eventsSummary

Cada cartelera se dividirá en tres tarjetas: main, prelims1 y prelims 2. Este objeto indicará la fecha de la cartelera y las tres tarjetas.

| Nombre de Campo | Tipo          | Descripción                                                 |
| --------------- | ------------- | ----------------------------------------------------------- |
| fights          | número entero | El número de peleas en esta tarjeta particular de la pelea. |
| startTime       | hora          | La hora estimada de inicio de esa tarjeta particular.       |

### Objeto bookingStatus

| Nombre de Campo | Tipo   | Descripción                                       |
| --------------- | ------ | ------------------------------------------------- |
| status          | cadena | Estado actual de la reserva del evento en el DDE. |

### **Objeto competitions**

| Nombre de Campo   | Tipo   | Descripción                                                             |
| ----------------- | ------ | ----------------------------------------------------------------------- |
| organisation      | cadena | La organización de la cartelera particular.                             |
| startDate         | fecha  | La fecha de inicio de la cartelera.                                     |
| endDate           | fecha  | La fecha de finalización de la cartelera.                               |
| licensingProperty | cadena | La propiedad DDE que otorga la licencia a esta cartelera en particular. |

### Respuesta de muestra

```
{
    "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-latam-spanish/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.