GET fixtures

Recupera uma lista de partidas (fixtures) com base em parâmetros como ID de torneio, ID de esporte, ID de participante, intervalo de datas e idioma.

Endpoint

GET /v4/fixtures

Requisição

Parâmetros

• tournamentId (number) — O identificador único do torneio. Este ID deve corresponder a um torneio existente.
• sportId (number) — O identificador único do esporte. Este ID deve corresponder a um esporte existente.
• participantId (number) — O identificador único do participante. Este ID deve corresponder a um participante existente.
• from (string) — A data e hora de início das partidas em formato ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• to (string) — A data e hora de término das partidas em formato ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• language (a2) — (Opcional) O idioma em que as informações do torneio devem ser retornadas. Por padrão, o valor é en for English
• statusId (number: 0,1,2,3) — O statusId que as partidas retornadas devem ter (0: Ainda não iniciada, 1: Ao vivo, 2: Finalizada, 3: Cancelada).
• hasOdds (boolean) — Indica se a partida tem odds disponíveis.
• bookmakers (string) — (Opcional) Lista de slugs de casas de apostas separados por vírgulas. Utilizada para avaliar o filtro hasOdds.

Condições

• tournamentId: Pode ser o único parâmetro fornecido.
• participantId: Pode ser o único parâmetro fornecido.
• sportId: Deve ser acompanhado por qualquer um de:
  • tournamentId
  • participantId
  • Ambos to e from, quando ambos os horários estão separados por menos de 10 dias.
• to e from:
  • Se tournamentId ou participantId forem fornecidos, to and from não são obrigatórios e fornecer apenas um é aceito.
  • Se somente to e from for fornecido, o intervalo deve ser menor que 48 horas.

Exemplo de requisição

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

Exemplo de resposta

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

Resposta (200 OK)

Em uma requisição bem-sucedida, o servidor responde com um código de status 200 e retorna um array JSON contendo objetos de partidas com os seguintes campos:

• fixtureId (string) — O identificador único da partida.
• participant1Id (number) — O ID do primeiro participante.
• participant2Id (number) — O ID do segundo participante.
• sportId (number) — O ID do esporte associado à partida.
• tournamentId (number) — O ID do torneio associado à partida.
• seasonId (number|null) — (Opcional) O ID da temporada.
• statusId (number) — O status atual da partida.
• hasOdds (boolean) — Indica se a partida tem odds disponíveis.
• startTime (string) — O horário de início da partida.
• trueStartTime (string|null) — O horário real de início da partida, se disponível.
• trueEndTime (string|null) — O horário real de término da partida, se disponível.
• updatedAt (string) — O timestamp da última atualização da partida.
• statusName (string) — Estado da partida legível (p. ex., «Pre-Game», «In-Play», «Ended»).
• participant1Name (string) — O nome do primeiro participante (no idioma solicitado).
• participant1ShortName (string) — Nome curto de exibição do primeiro participante. Traduzido se o parâmetro language estiver definido.
• participant1Abbr (string) — Abreviação de 3 letras do primeiro participante. Traduzida se o parâmetro language estiver definido.
• participant2Name (string) — O nome do segundo participante (no idioma solicitado).
• participant2ShortName (string) — Nome curto de exibição do segundo participante. Traduzido se o parâmetro language estiver definido.
• participant2Abbr (string) — Abreviação de 3 letras do segundo participante. Traduzida se o parâmetro language estiver definido.
• sportName (string) — O nome do esporte associado ao evento.
• tournamentSlug (string) — Identificador do torneio compatível com URL.
• categorySlug (string) — Slug da categoria da competição (p. ex., «england»).
• categoryName (string) — O nome da categoria à qual o torneio pertence.
• tournamentName (string) — O nome do torneio.
• externalProviders (object) — IDs de provedores terceirizados:
  • betradarId (number|null) — (Opcional) O ID atribuído pela Betradar.
  • mollybetId (string|null) — (Opcional) O ID único atribuído pela Mollybet.
  • opticoddsId (string|null) — (Opcional) O ID único atribuído pela Opticodds.
  • lsportsId (number|null) — (Opcional) O ID único atribuído pela LSports.
  • txoddsId (number|null) — (Opcional) O ID único atribuído pela TXOdds.
  • sofascoreId (number|null) — (Opcional) O ID atribuído pela Sofascore.
  • betgeniusId (number|null) — (Opcional) O ID atribuído pela Betgenius.
  • flashscoreId (string|null) — (Opcional) O ID atribuído pela Flashscore.
  • pinnacleId (number|null) — (Opcional) O ID atribuído pela Pinnacle.
  • oddinId (number|null) — (Opcional) O ID atribuído pela Oddin.