V3 Match Endpoints

V3 match detail endpoints: summary, statistics, lineups, H2H, commentary, odds, and more

Match Endpoints

All match endpoints use string-based event IDs (e.g., l2TocbiL). Discover event IDs from the sport score endpoints (e.g., /api/v1/football/live).

---

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).

Real Response (Verified):

{
  "eventId": "l2TocbiL",
  "periods": [
    { "period": "3", "homeScore": 0, "awayScore": 0 }
  ],
  "matchInfo": {
    "CAP": "69 500"
  },
  "incidents": [
    {
      "id": "dM00VIZh",
      "type": "card",
      "minute": "51'",
      "side": "away",
      "player": "Khairi A.",
      "playerUrl": "/player/khairi-ayoub/WURowHOm/",
      "playerId": "WURowHOm",
      "description": "Yellow Card",
      "assist": null
    },
    {
      "id": "4rr1mBZA",
      "type": "goal",
      "minute": null,
      "side": "3",
      "player": "Hammoudan A.",
      "playerUrl": "/player/hamoudane-ahmed/t4dwg7K1/",
      "playerId": "t4dwg7K1",
      "description": "Goal",
      "assist": null
    }
  ]
}

V3 incidents include playerUrl and playerId as string fields. The side field may be "home", "away", or a numeric string. The minute field includes the ' symbol (e.g., "51'").

---

Match Statistics

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

Returns match statistics organized by category.

---

Match Lineups

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

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

---

Match Head-to-Head

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

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

---

Match Scores

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

Returns period-by-period score breakdown.

---

Match Standings

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

Returns standings context for the match’s league.

---

Match Commentary

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

Returns live/post-match text commentary.

---

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

---

Match Timeline

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

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

---

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).

---

Match Top Scorers

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

Returns top scorers for the match’s league context.

---

Match Odds

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

Returns detailed bookmaker odds comparison for the match.

---

Match Tournament Odds

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

Returns season outright / tournament winner odds.

---

Match News

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

Returns news articles related to the specific match.

---

Match Report

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

Returns the post-match report content.

---

Example Requests

cURL

curl -H "x-api-key: YOUR_API_KEY" \
  https://v3.football.sportsapipro.com/api/v1/match/l2TocbiL