GET fixture

Recupera uma única partida com base no ID da partida. A resposta inclui informações detalhadas sobre a partida, incluindo nomes dos participantes, IDs e mapeamentos de provedores externos. Este endpoint não retorna odds das casas de apostas para a partida.

Endpoint

GET /v4/fixture

Parâmetros da requisição

  • fixtureId* (string)ID único da partida (p. ex., id1000001761301153).
  • language (string) (Opcional) Código de idioma para rótulos traduzidos (p. ex., en, de, es). Padrão: en.

Exemplo de requisição

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

Resposta de exemplo

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

Detalhamento dos campos da resposta

Campos de nível superior

  • fixtureId (string) ID interno único da partida.
  • participant1Id (number) ID do primeiro participante.
  • participant2Id (number) ID do segundo participante.
  • sportId (number) ID que representa o esporte (p. ex., 10 = Futebol, 12 = Tênis).
  • tournamentId (number) ID do torneio.
  • seasonId (number|null) ID da temporada, se aplicável.
  • statusId (number) Código de estado da partida (p. ex., 0 = Pré-jogo, 1 = Agendado, 2 = Ao vivo, 3 = Encerrado).
  • hasOdds (boolean) Indica se há dados de odds disponíveis para esta partida.
  • startTime (string) Carimbo de data/hora ISO 8601 do início programado (UTC).
  • trueStartTime (string|null) Hora de início real, se diferente da agendada (p. ex., chute inicial atrasado).
  • trueEndTime (string|null) Hora de término real da partida, se disponível.
  • updatedAt (string) Carimbo de data/hora ISO 8601 da última atualização (UTC).
  • statusName (string) Estado da partida legível (p. ex., «Pre-Game», «In-Play», «Ended»).
  • participant1Name (string) Nome completo do primeiro participante. Traduzido se o parâmetro language estiver definido.
  • 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) Nome completo do segundo participante. Traduzido se o parâmetro language estiver definido.
  • 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) Nome do esporte.
  • tournamentSlug (string) Identificador do torneio compatível com URL.
  • categorySlug (string) Slug da categoria da competição (p. ex., «england»).
  • categoryName (string) Nome de exibição da categoria (p. ex., «England»).
  • tournamentName (string) Nome completo do torneio (traduzido se o parâmetro language estiver definido).
  • externalProviders (object) IDs de provedores de terceiros.:
    • betradarId (number|null) ID do feed da Betradar.
    • mollybetId (string|null) Identificador composto da Mollybet.
    • opticoddsId (string|null) Identificador da OpticOdds.
    • lsportsId (number|null) Identificador da LSports.
    • txoddsId (number|null) Identificador da TXOdds.
    • sofascoreId (number|null) ID da partida na Sofascore.
    • betgeniusId (number|null) ID da partida na Betgenius.
    • flashscoreId (string|null) ID da partida na Flashscore.
    • pinnacleId (number|null) ID interno da partida na Pinnacle.
    • oddinId (number|null) ID da partida na Oddin.

Notas

  • Cooldown do endpoint (limite de taxa): 500ms
  • Todos os carimbos de data/hora estão em UTC (ISO 8601).
  • Este endpoint não inclui odds das casas de apostas. Use o endpoint /v4/odds para obter odds de uma partida.
Página anteriorGET fixtures
Próxima páginaGET markets
Reportar um problema
OddsPapi | Docs GET fixture