Competitions

Competitions are the league-level container. From a competition ID you can fetch standings, results, upcoming games, brackets, top scorers, transfers, and news.

Endpoints

Endpoint	Returns
`GET /api/v1/competitions?sportId={id}`	All competitions for a sport. Optionally `&countryId={id}`.
`GET /api/v1/{sport}/competitions`	Active competitions for one sport.
`GET /api/v1/{sport}/countries`	Countries that host competitions in this sport.
`GET /api/v1/competition/{id}/standings`	League table. `?seasonNum={num}` for historical seasons.
`GET /api/v1/competition/{id}/results`	Recently completed games (paginated).
`GET /api/v1/competition/{id}/games`	Upcoming and recent games.
`GET /api/v1/competition/{id}/stats`	Stat leaders (player + team). Categories differ per sport — football has 16 player categories, basketball 7.
`GET /api/v1/competition/{id}/brackets`	Knockout / playoff bracket tree.
`GET /api/v1/competition/{id}/transfers`	Player transfer feed for the competition. Verified example: competition `73` (Portugal Primeira Liga) returns 351 transfers. Recommended competition-level transfer route.
`GET /api/v1/competition/{id}/news`	Competition-tagged news.

Standings (real sample)

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v1/football/competition/11/standings

{
  "standings": [
    {
      "competitionId": 11,
      "seasonNum": 98,
      "stageNum": 1,
      "isCurrentStage": true,
      "displayName": "LaLiga",
      "headers": [
        { "key": "gamePlayed", "name": "P",   "isMajor": true },
        { "key": "goals",      "name": "F:A", "isMajor": true },
        { "key": "ratio",      "name": "+/-", "isMajor": true },
        { "key": "points",     "name": "PTS", "isMajor": true },
        { "key": "gamesWon",   "name": "W" },
        { "key": "gamesEven",  "name": "D" },
        { "key": "gamesLost",  "name": "L" },
        { "key": "recentForm", "name": "Form" }
      ],
      "rows": [
        {
          "competitor": {
            "id": 132, "name": "FC Barcelona", "shortName": "Barcelona",
            "symbolicName": "BAR", "color": "#282E60"
          },
          "position": 1,
          "gamePlayed": 29, "gamesWon": 24, "gamesEven": 1, "gamesLost": 4,
          "for": 78, "against": 28, "ratio": 50.0, "points": 73,
          "recentForm": [1, 1, 1, 1, 1]
        }
      ]
    }
  ]
}

recentForm[] values: 1 win, 0 draw, -1 loss.

Historical seasons

Append ?seasonNum={num} to standings, results, and stats. Discover season numbers from the current standings[].seasonNum and walk back.

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v1/football/competition/11/standings?seasonNum=97"

Stats — top scorers and team stats

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v1/football/competition/11/stats

Returns two arrays under data.stats:

athletesStats[] — 16 player categories: Goals, Expected Goals, Assists, Expected Assists, Goals and Assists, Expected Goals + Assists, Shots On Target, Big Chances Created, Successful Dribbles, Tackles Won, Interceptions, Clearances, Clean Sheets, Saves, Yellow Cards, Red Cards.
competitorsStats[] — 9 team categories: Goals Scored, Goals Conceded, Shots On Target, Possession %, Pass Accuracy %, Tackles Won, Clean Sheets, Yellow Cards, Red Cards.

Each row exposes top-20 entities with entity (id, name, positionName, nameForURL) and stats[].value. See Sports & Format for the numeric category IDs.

Basketball stat leaders

The same endpoint is the only way to fetch many basketball players in one request — Basketball V2 has no season leaderboard.

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v1/basketball/competition/106/stats

Verified live on WNBA (106) and Australian NBL (5486).

athletesStats[] — 7 player categories, top 20 rows each: 1 Points Per Game, 2 Assists Per Game, 3 Rebounds Per Game, 4 Steals Per Game, 5 Turnovers Per Game, 6 Blocks Per Game, 7 Fouls Per Game.
competitorsStats[] — 10 team categories, all teams: 1 Field Goal %, 2 3 Point %, 3 Free Throw %, 4 Rebounds Per Game, 5 Defensive Rebounds Per Game, 6 Offensive Rebounds Per Game, 7 Assists Per Game, 8 Blocks Per Game, 9 Steals Per Game, 10 Turnovers Per Game.
athletesInfoText — the eligibility rule: for non-aggregative statistics a player must have played at least 30% of completed team games.

Each player row carries entity with id, name, competitorId (team), positionName and imageVersion, so headshots and drill-down work directly.

Basketball caveats, all confirmed by testing:

Empty payloads out of season. Some competitions return data: {} — NBA (53) while the season has not tipped off, Japan B.League (8361), Euroleague Women (6817). There is no hasStats flag on the competition object: probe the endpoint and treat an empty data object as “not available yet”. Historical seasons are not a workaround — ?seasonNum={num} on an empty competition still returns {}.
The competitors filter is ignored. ?competitors={teamId} returns the unfiltered leader tables. Filter client-side on entity.competitorId.
Competition IDs are global across sports. Passing a football ID to /v1/basketball/... returns that football competition’s “Goals” leaders with no error. Always resolve IDs from /v1/basketball/competitions.

Brackets (knockout)

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v1/football/competition/29/brackets

{
  "brackets": [
    {
      "num": 73,
      "name": "2025/2026",
      "title": "UEFA Champions League 2025/2026 Bracket",
      "competitionId": 572,
      "stages": [
        { "num": 1, "name": "League Phase", "stageType": 1, "hasStandings": true },
        {
          "num": 2,
          "name": "Playoffs",
          "groups": [
            {
              "num": 1, "name": "Group 1",
              "participants": [
                { "name": "Monaco", "competitorId": 471, "symbolicName": "Mon", "isQualified": false },
                { "name": "PSG",    "competitorId": 480, "symbolicName": "PSG", "isQualified": true }
              ],
              "games": [
                { "num": 1, "startTime": "2026-02-17T20:00:00+00:00", "gameId": 4663204 }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Walk brackets[].stages[].groups[].games[].gameId to drive a knockout view.

Transfers

{
  "transfers": [
    {
      "id": 358568,
      "type": 6,
      "origin": 888, "target": 131,
      "time": "2026-06-12T10:41:31.586Z",
      "price": "Appointed",
      "athleteId": 46116,
      "statusId": 2, "statusName": "Confirmed",
      "isArrival": false, "isDeparture": true
    }
  ]
}

type: 1 = Loan, 2 = Permanent, 3 = End of loan, 6 = Staff appointment.

Popular competition IDs

Sport	ID	Name
Football	7	Premier League
Football	11	LaLiga
Football	16	Serie A
Football	25	Bundesliga
Football	12	Ligue 1
Football	29	UEFA Champions League
Football	35	UEFA Europa League
Football	103	MLS
Football	595	Saudi Pro League
Football	5930	FIFA World Cup 2026
Basketball	53	NBA
Hockey	110	NHL
American Football	55	NFL
Baseball	113	MLB

For a fully built-out World Cup integration with hardcoded IDs, see V1 World Cup 2026.

Teams — drill from a standings row into team fixtures.
Head-to-Head — compare two teams.
News — competition-scoped news.

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

Endpoints

Standings (real sample)

Historical seasons

Stats — top scorers and team stats

Basketball stat leaders

Brackets (knockout)

Transfers

Popular competition IDs

​Endpoints

​Standings (real sample)

​Historical seasons

​Stats — top scorers and team stats

​Basketball stat leaders

​Brackets (knockout)

​Transfers

​Popular competition IDs

​Related

Endpoints

Standings (real sample)

Historical seasons

Stats — top scorers and team stats

Basketball stat leaders

Brackets (knockout)

Transfers

Popular competition IDs

Related