Competitions

Full competition detail, matches, standings, top scorers, transfers, stats, seasons & archive

All competition endpoints accept an optional season_id query parameter to load historical seasons. Without it, the current season is returned.

Competition Detail (Full)

GET /api/v1/competition/{compId}/detail?sport=football&season_id={id}

Returns the complete competition payload — teams, matches, stages, standings, players, honors, and venues.

New canonical

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/competition/mo07dni2vfxknxy/detail"

{
  "success": true,
  "compDetail": {
    "competition": {
      "id": "mo07dni2vfxknxy",
      "name": "English Premier League",
      "curSeasonId": "o07dnidyr8awknx",
      "roundCount": 38,
      "curRound": 1
    }
  },
  "teams":    [{ "id": "2ezk96irrwhwkn5", "name": "Arsenal", "slug": "arsenal" }],
  "matches":  [],
  "stages":   [{ "id": "235026", "name": "League", "roundCount": 38 }],
  "tables":   { "tables": [{ "rows": [{ "team": {}, "fbDetail": {} }] }] },
  "players":  [],
  "venues":   [{ "id": 1, "name": "Anfield", "capacity": 61276 }],
  "compHonors": { "seasonHonors": [{ "season": { "year": "2024-2025" }, "items": [] }] }
}

Verified: EPL → 31 teams, 380 matches, 20 venues, 127 seasons of honors. WC 2026 → 83 teams, 104 matches, 17 venues, 22 seasons of honors.

Competition Matches

GET /api/v1/competition/{compId}/matches?season_id={id}

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/competition/mo07dni2vfxknxy/matches"

Competition Standings

GET /api/v1/competition/{compId}/standings?season_id={id}

Returns flattened league tables with team names. Standings detail keys:

Key	Meaning	Key	Meaning
1	Played	7	Goals For
2	Wins	8	Goals Against
3	Draws	9	Goal Difference
4	Losses	10	Points

Top Scorers

GET /api/v1/competition/{compId}/top-scorers?season_id={id}

Competition Transfers

GET /api/v1/competition/{compId}/transfers

Transfers may return an empty array or fail for some smaller competitions.

Competition Stats

GET /api/v1/competition/{compId}/stats?season_id={id}

Seasons & Archive

GET /api/v1/competition/{compId}/seasons
GET /api/v1/competition/{compId}/archive

seasons returns every season ID you can pass back as season_id (EPL ships 24 seasons from 2003-04 to 2026-27). archive returns the historical champions list with team names (EPL ships 127 seasons back to 1888).

Cache TTL: 10 minutes for all competition endpoints.