GET fixture

Recupera un único partido según su ID. La respuesta incluye información detallada del partido, incluidos los nombres de los participantes, IDs y mapeos de proveedores externos. Este endpoint no devuelve cuotas de las casas de apuestas para el partido.

Endpoint

GET /v4/fixture

Parámetros de la petición

  • fixtureId* (string)ID único del partido (p. ej., id1000001761301153).
  • language (string) (Opcional) Código de idioma para etiquetas traducidas (p. ej., en, de, es). El valor predeterminado es en.

Ejemplo de petición

GET /v4/fixture?fixtureId=id1000001761301153&language=en

Respuesta de muestra

{
  "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"
}

Desglose de campos de la respuesta

Campos de nivel superior

  • fixtureId (string) ID interno único del partido.
  • participant1Id (number) ID del primer participante.
  • participant2Id (number) ID del segundo participante.
  • sportId (number) ID que representa el deporte (p. ej., 10 = Fútbol, 12 = Tenis).
  • tournamentId (number) ID del torneo.
  • seasonId (number|null) ID de la temporada, si corresponde.
  • statusId (number) Código de estado del partido (p. ej., 0 = Pre-partido, 1 = Programado, 2 = En juego, 3 = Finalizado).
  • hasOdds (boolean) Indica si hay datos de cuotas disponibles para este partido.
  • startTime (string) Marca de tiempo ISO 8601 del inicio programado (UTC).
  • trueStartTime (string|null) Hora de inicio real si difiere de la programada (p. ej., saque retrasado).
  • trueEndTime (string|null) Hora de finalización real del partido, si está disponible.
  • updatedAt (string) Marca de tiempo ISO 8601 de la última actualización (UTC).
  • statusName (string) Estado del partido legible (p. ej., «Pre-Game», «In-Play», «Ended»).
  • participant1Name (string) Nombre completo del primer participante. Traducido si se establece el parámetro language.
  • 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) Nombre completo del segundo participante. Traducido si se establece el parámetro language.
  • 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) Nombre del deporte.
  • tournamentSlug (string) Identificador del torneo apto para URL.
  • categorySlug (string) Slug de la categoría de competición (p. ej., «england»).
  • categoryName (string) Nombre visible de la categoría (p. ej., «England»).
  • tournamentName (string) Nombre completo del torneo (traducido si se establece el parámetro language).
  • externalProviders (object) IDs de proveedores externos.:
    • betradarId (number|null) ID del feed de Betradar.
    • mollybetId (string|null) Identificador compuesto de Mollybet.
    • opticoddsId (string|null) Identificador de OpticOdds.
    • lsportsId (number|null) Identificador de LSports.
    • txoddsId (number|null) Identificador de TXOdds.
    • sofascoreId (number|null) ID de partido de Sofascore.
    • betgeniusId (number|null) ID de partido de Betgenius.
    • flashscoreId (string|null) ID de partido de Flashscore.
    • pinnacleId (number|null) ID interno del partido en Pinnacle.
    • oddinId (number|null) ID de partido de Oddin.

Notas

  • Enfriamiento del endpoint (límite de velocidad): 500ms
  • Todas las marcas de tiempo están en UTC (ISO 8601).
  • Este endpoint no incluye cuotas. Use el endpoint /v4/odds para obtener cuotas de un partido.
Página anteriorGET fixtures
Página siguienteGET markets
Informar de un problema
OddsPapi | Docs GET fixture