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

# Get League Standings

> Build standings tables for leagues, cups, groups, and teams.

Use `GET /v1/football/standings` to return one or more standings tables for a league, cup, group stage, or team.

## League standings

```bash theme={"system"}
curl --request GET \
  "https://api.nextsportsapi.com/v1/football/standings?league=L7K9Q2R&season=2026" \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Team standings for a season

```bash theme={"system"}
curl --request GET \
  "https://api.nextsportsapi.com/v1/football/standings?team=T3MUN7A&season=2026" \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Response shape

The response contains a `league` object and a nested `standings` array. Some competitions return multiple tables, such as group stages, opening and closing tables, or cup phases.

```json theme={"system"}
{
  "response": [
    {
      "league": {
        "id": "L7K9Q2R",
        "name": "Premier League",
        "season": 2026,
        "standings": [
          [
            {
              "rank": 1,
              "team": {
                "id": "T8LIV4B",
                "name": "Liverpool"
              },
              "points": 70,
              "goalsDiff": 41,
              "form": "WWWWW"
            }
          ]
        ]
      }
    }
  ]
}
```

## Caching

Refresh standings hourly for leagues with active fixtures. For leagues with no live or recently completed matches, refresh daily.