Match Endpoints

All match endpoints use string-based event IDs (e.g., xpzR5OKq).

Match Summary

GET /api/v1/match/{eventId}
GET /api/v1/match/{eventId}/summary

Returns match summary with period scores, venue info, and incidents (goals, cards, substitutions). Response:

{
  "id": "xpzR5OKq",
  "startTime": "2026-04-04T15:00:00.000Z",
  "statusCode": 3,
  "status": "finished",
  "homeTeam": { "name": "Manchester City", "id": "Wtn9Stg0" },
  "awayTeam": { "name": "Arsenal", "id": "ppjDR086" },
  "homeScore": { "current": 2, "halfTime": 1 },
  "awayScore": { "current": 1, "halfTime": 0 },
  "venue": { "name": "Etihad Stadium", "city": "Manchester" },
  "incidents": [
    {
      "type": "goal",
      "time": 23,
      "player": "Haaland",
      "team": "home",
      "assist": "De Bruyne"
    },
    {
      "type": "yellowCard",
      "time": 41,
      "player": "Rice",
      "team": "away"
    }
  ]
}

Match Statistics

GET /api/v1/match/{eventId}/statistics

Returns match statistics (possession, shots, passes, xG, etc.) organized by category. Response:

{
  "id": "xpzR5OKq",
  "statistics": [
    {
      "category": "Match Overview",
      "items": [
        { "name": "Ball Possession", "home": "58%", "away": "42%" },
        { "name": "Total Shots", "home": "14", "away": "9" },
        { "name": "Shots on Target", "home": "6", "away": "3" },
        { "name": "Expected Goals (xG)", "home": "1.82", "away": "0.94" }
      ]
    },
    {
      "category": "Passes",
      "items": [
        { "name": "Total Passes", "home": "524", "away": "381" },
        { "name": "Pass Accuracy", "home": "87%", "away": "81%" }
      ]
    }
  ]
}

Match Lineups

GET /api/v1/match/{eventId}/lineups

Returns formations, starting lineups, substitutes with player ratings and positions. Response:

{
  "id": "xpzR5OKq",
  "home": {
    "formation": "4-3-3",
    "starters": [
      {
        "name": "Ederson",
        "position": "GK",
        "number": 31,
        "rating": "7.2",
        "playerId": "abc123"
      }
    ],
    "substitutes": [
      {
        "name": "Grealish",
        "position": "FW",
        "number": 10,
        "playerId": "def456"
      }
    ]
  },
  "away": {
    "formation": "4-3-3",
    "starters": [],
    "substitutes": []
  }
}

Match Head-to-Head

GET /api/v1/match/{eventId}/h2h

Returns head-to-head history and recent form for both teams. Response:

{
  "id": "xpzR5OKq",
  "h2h": {
    "totalMatches": 210,
    "homeWins": 98,
    "awayWins": 72,
    "draws": 40,
    "matches": [
      {
        "id": "prev123",
        "date": "2025-10-12",
        "homeTeam": "Arsenal",
        "awayTeam": "Manchester City",
        "homeScore": 1,
        "awayScore": 1
      }
    ]
  },
  "homeForm": ["W", "W", "D", "L", "W"],
  "awayForm": ["W", "D", "W", "W", "L"]
}

Match Scores

GET /api/v1/match/{eventId}/scores

Returns period-by-period score breakdown. Response:

{
  "id": "xpzR5OKq",
  "periods": [
    { "name": "1st Half", "home": 1, "away": 0 },
    { "name": "2nd Half", "home": 1, "away": 1 }
  ],
  "finalScore": { "home": 2, "away": 1 }
}

Match Standings

GET /api/v1/match/{eventId}/standings

Returns standings context for the match’s league. Response:

{
  "id": "xpzR5OKq",
  "leagueName": "Premier League",
  "standings": [
    {
      "position": 1,
      "team": { "name": "Manchester City", "id": "Wtn9Stg0" },
      "played": 30,
      "won": 22,
      "drawn": 5,
      "lost": 3,
      "goalsFor": 68,
      "goalsAgainst": 24,
      "points": 71
    }
  ]
}

Match Commentary

GET /api/v1/match/{eventId}/commentary

Returns live/post-match text commentary. Response:

{
  "id": "xpzR5OKq",
  "commentary": [
    {
      "time": "90+3",
      "text": "Full Time - Manchester City 2, Arsenal 1."
    },
    {
      "time": "78",
      "text": "Goal! Manchester City 2, Arsenal 1. Foden scores from inside the box."
    },
    {
      "time": "52",
      "text": "Goal! Manchester City 1, Arsenal 1. Saka equalizes with a curling shot."
    }
  ]
}

Match Config

GET /api/v1/match/{eventId}/config

Returns event configuration including available data tabs and current status. Tab codes: MR=Match Results, ST=Statistics, PS=Player Stats, LI=Lineups, LC=Live Commentary, MC=Match Commentary, OD=Odds, HH=Head-to-Head, TTS=Team Standings, SCR=Scores Response:

{
  "id": "xpzR5OKq",
  "tabs": ["MR", "ST", "LI", "MC", "OD", "HH", "TTS", "SCR"],
  "status": "finished",
  "statusCode": 3
}

Match Timeline

GET /api/v1/match/{eventId}/timeline

Returns live standings and timeline data for the match’s league context. Response:

{
  "id": "xpzR5OKq",
  "timeline": [
    { "time": 23, "type": "goal", "team": "home", "player": "Haaland" },
    { "time": 41, "type": "yellowCard", "team": "away", "player": "Rice" },
    { "time": 52, "type": "goal", "team": "away", "player": "Saka" },
    { "time": 78, "type": "goal", "team": "home", "player": "Foden" }
  ]
}

Match Checksums

GET /api/v1/match/{eventId}/checksums

Returns hash checksums for each data section — useful for change detection (only re-fetch when checksum changes). Response:

{
  "id": "xpzR5OKq",
  "checksums": {
    "summary": "a1b2c3d4",
    "statistics": "e5f6g7h8",
    "lineups": "i9j0k1l2",
    "commentary": "m3n4o5p6",
    "odds": "q7r8s9t0"
  }
}

Match Top Scorers

GET /api/v1/match/{eventId}/top-scorers

Returns top scorers for the match’s league context. Response:

{
  "id": "xpzR5OKq",
  "leagueName": "Premier League",
  "topScorers": [
    {
      "rank": 1,
      "player": "Haaland",
      "team": "Manchester City",
      "goals": 24,
      "assists": 5
    },
    {
      "rank": 2,
      "player": "Salah",
      "team": "Liverpool",
      "goals": 19,
      "assists": 11
    }
  ]
}

Match Odds

GET /api/v1/match/{eventId}/odds

Returns detailed bookmaker odds comparison for the match. Response:

{
  "id": "xpzR5OKq",
  "odds": [
    {
      "bookmaker": "Bookmaker A",
      "markets": {
        "1x2": { "home": 1.65, "draw": 3.80, "away": 5.00 },
        "overUnder2.5": { "over": 1.72, "under": 2.10 }
      }
    }
  ]
}

Match Tournament Odds

GET /api/v1/match/{eventId}/tournament-odds

Returns season outright / tournament winner odds. Response:

{
  "id": "xpzR5OKq",
  "tournamentName": "Premier League",
  "outrights": [
    { "team": "Manchester City", "odds": 1.50 },
    { "team": "Arsenal", "odds": 3.25 },
    { "team": "Liverpool", "odds": 4.00 }
  ]
}

Match News

GET /api/v1/match/{eventId}/news

Returns news articles related to the specific match. Response:

{
  "id": "xpzR5OKq",
  "articles": [
    {
      "title": "Manchester City edge past Arsenal in thriller",
      "description": "A late goal from Foden secured all three points...",
      "url": "https://example.com/article/123",
      "publishedAt": "2026-04-04T18:30:00.000Z",
      "source": "Sports News"
    }
  ]
}

Match Report

GET /api/v1/match/{eventId}/report

Returns the post-match report content. Response:

{
  "id": "xpzR5OKq",
  "report": {
    "title": "Manchester City 2-1 Arsenal",
    "content": "Manchester City came from behind to beat Arsenal 2-1 at the Etihad Stadium...",
    "publishedAt": "2026-04-04T19:00:00.000Z"
  }
}

V3 API

​Match Endpoints

​Match Summary

​Match Statistics

​Match Lineups

​Match Head-to-Head

​Match Scores

​Match Standings

​Match Commentary

​Match Config

​Match Timeline

​Match Checksums

​Match Top Scorers

​Match Odds

​Match Tournament Odds

​Match News

​Match Report