V3 Match Endpoints

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://api.sportsapipro.com/v3/football/match/l2TocbiL

const response = await fetch(
  'https://api.sportsapipro.com/v3/football/match/l2TocbiL',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();
console.log(`Match ${data.eventId}: ${data.incidents?.length || 0} incidents`);

import requests

response = requests.get(
    'https://api.sportsapipro.com/v3/football/match/l2TocbiL',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

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

Example Requests

​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

​Example Requests

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

Example Requests