> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

<CodeGroup>
  ```bash New canonical theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/competition/mo07dni2vfxknxy/detail"
  ```

  ```bash Classic theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/competition/mo07dni2vfxknxy/detail"
  ```
</CodeGroup>

```json theme={null}
{
  "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

```text theme={null}
GET /api/v1/competition/{compId}/matches?season_id={id}
```

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/competition/mo07dni2vfxknxy/matches"
```

## Competition Standings

```text theme={null}
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

```text theme={null}
GET /api/v1/competition/{compId}/top-scorers?season_id={id}
```

## Competition Transfers

```text theme={null}
GET /api/v1/competition/{compId}/transfers
```

<Warning>
  Transfers may return an empty array or fail for some smaller competitions.
</Warning>

## Competition Stats

```text theme={null}
GET /api/v1/competition/{compId}/stats?season_id={id}
```

## Seasons & Archive

```text theme={null}
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.