GET fixtures

Recupera una lista de partidos basada en parámetros como ID de torneo, ID de deporte, ID de participante, rango de fechas e idioma.

Endpoint

GET /v4/fixtures

Petición

Parámetros

• tournamentId (number) — El identificador único del torneo. Este ID debe corresponder a un torneo existente.
• sportId (number) — El identificador único del deporte. Este ID debe corresponder a un deporte existente.
• participantId (number) — El identificador único del participante. Este ID debe corresponder a un participante existente.
• from (string) — La fecha y hora de inicio para los partidos en formato ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• to (string) — La fecha y hora de fin para los partidos en formato ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• language (a2) — (Opcional) El idioma en el que se debe devolver la información del torneo. Por defecto, el valor es en for English
• statusId (number: 0,1,2,3) — El statusId que deben tener los partidos devueltos (0: Aún no iniciado, 1: En vivo, 2: Finalizado, 3: Cancelado).
• hasOdds (boolean) — Indica si el partido tiene cuotas disponibles.
• bookmakers (string) — (Opcional) Lista de slugs de casas de apuestas separados por comas. Se utiliza para evaluar el filtro hasOdds.

Condiciones

• tournamentId: Puede ser el único parámetro proporcionado.
• participantId: Puede ser el único parámetro proporcionado.
• sportId: Debe ir acompañado de cualquiera de:
  • tournamentId
  • participantId
  • Ambos to y from, donde ambos momentos estén separados por menos de 10 días.
• to y from:
  • Si tournamentId o participantId son proporcionados, to and from no son obligatorios y proporcionar solo uno es aceptado.
  • Si solo to y from se proporciona, deben estar separados por menos de 48 horas.

Ejemplo de petición

GET /v4/fixtures?sportId=10&from=2026-04-12&to=2026-04-17&statusId=0&hasOdds=true&bookmakers=pinnacle

Ejemplo de respuesta

[
  {
    "fixtureId": "id1000001761301153",
    "participant1Id": 35,
    "participant2Id": 34,
    "sportId": 10,
    "tournamentId": 17,
    "seasonId": 130281,
    "statusId": 0,
    "hasOdds": true,
    "startTime": "2026-04-13T19:00:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2026-04-06T23:17:08.202Z",
    "externalProviders": {
      "betradarId": 61301153,
      "mollybetId": "2026-04-13,35,34",
      "opticoddsId": "20260413A1B2C3D4",
      "lsportsId": null,
      "txoddsId": null,
      "sofascoreId": 15676100,
      "betgeniusId": 13670012,
      "flashscoreId": "xK4pLm2n",
      "pinnacleId": 1626291706,
      "oddinId": null
    },
    "statusName": "Pre-Game",
    "participant1Name": "Liverpool FC",
    "participant1ShortName": "Liverpool",
    "participant1Abbr": "LIV",
    "participant2Name": "Manchester United",
    "participant2ShortName": "Man Utd",
    "participant2Abbr": "MNU",
    "sportName": "Soccer",
    "tournamentSlug": "premier-league",
    "categorySlug": "england",
    "categoryName": "England",
    "tournamentName": "Premier League"
  }
]

Respuesta (200 OK)

En una petición exitosa, el servidor responde con el código de estado 200 y devuelve un array JSON que contiene objetos de partidos con los siguientes campos:

• fixtureId (string) — El identificador único del partido.
• participant1Id (number) — El ID del primer participante.
• participant2Id (number) — El ID del segundo participante.
• sportId (number) — El ID del deporte asociado al partido.
• tournamentId (number) — El ID del torneo asociado al partido.
• seasonId (number|null) — (Opcional) El ID de la temporada.
• statusId (number) — El estado actual del partido.
• hasOdds (boolean) — Indica si el partido tiene cuotas disponibles.
• startTime (string) — La hora de inicio del partido.
• trueStartTime (string|null) — La hora real de inicio del partido, si está disponible.
• trueEndTime (string|null) — La hora real de fin del partido, si está disponible.
• updatedAt (string) — La marca de tiempo de la última actualización del partido.
• statusName (string) — Estado del partido legible (p. ej., «Pre-Game», «In-Play», «Ended»).
• participant1Name (string) — El nombre del primer participante (en el idioma solicitado).
• participant1ShortName (string) — Nombre corto de visualización del primer participante. Traducido si se establece el parámetro language.
• participant1Abbr (string) — Abreviatura de 3 letras del primer participante. Traducido si se establece el parámetro language.
• participant2Name (string) — El nombre del segundo participante (en el idioma solicitado).
• participant2ShortName (string) — Nombre corto de visualización del segundo participante. Traducido si se establece el parámetro language.
• participant2Abbr (string) — Abreviatura de 3 letras del segundo participante. Traducido si se establece el parámetro language.
• sportName (string) — El nombre del deporte asociado con el evento.
• tournamentSlug (string) — Identificador del torneo apto para URL.
• categorySlug (string) — Slug de la categoría de competición (p. ej., «england»).
• categoryName (string) — El nombre de la categoría a la que pertenece el torneo.
• tournamentName (string) — El nombre del torneo.
• externalProviders (object) — IDs de proveedores externos:
  • betradarId (number|null) — (Opcional) El ID asignado por Betradar.
  • mollybetId (string|null) — (Opcional) El ID único asignado por Mollybet.
  • opticoddsId (string|null) — (Opcional) El ID único asignado por Opticodds.
  • lsportsId (number|null) — (Opcional) El ID único asignado por LSports.
  • txoddsId (number|null) — (Opcional) El ID único asignado por TXOdds.
  • sofascoreId (number|null) — (Opcional) El ID asignado por Sofascore.
  • betgeniusId (number|null) — (Opcional) El ID asignado por Betgenius.
  • flashscoreId (string|null) — (Opcional) El ID asignado por Flashscore.
  • pinnacleId (number|null) — (Opcional) El ID asignado por Pinnacle.
  • oddinId (number|null) — (Opcional) El ID asignado por Oddin.