Skip to main content

​
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'").
Incident type values: "goal", "yellowCard", "redCard", "card", "substitution". Numeric side mapping: when side is a string digit, "3" = home and "4" = away. Some responses return "home" / "away" directly — handle both.

​
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. Standings row fields: rank, name, id, played, wins, draws, losses, goalsFor, goalsAgainst, goalDifference, points, plus:
  • form — array of the last 5 results, e.g. ["W","W","D","L","W"]
  • qualification — qualification status text, e.g. "Qualified for: Play Offs"
  • qualColor — hex color (no #) for the qualification zone, e.g. "004682"
{
  "rank": 1,
  "name": "Velez Sarsfield",
  "id": "CMVwerg2",
  "played": 17, "wins": 13, "draws": 2, "losses": 2,
  "goalsFor": 36, "goalsAgainst": 11, "goalDifference": 25, "points": 41,
  "form": ["W","W","D","W","L"],
  "qualification": "Qualified for: Play Offs",
  "qualColor": "004682"
}

​
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 -H "x-api-key: YOUR_API_KEY" \
  https://v3.football.sportsapipro.com/api/v1/match/l2TocbiL
Last modified on June 11, 2026