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

# API Documentation

> Build football products with live scores, fixtures, standings, teams, players, and match statistics.

NextSportsAPI provides REST endpoints for football data products, including live match data, schedules, standings, teams, players, and match detail datasets.

## Base URL

```text theme={"system"}
https://api.nextsportsapi.com
```

## Authentication

All API requests require an API key in the `Authorization` header.

```http theme={"system"}
Authorization: Bearer YOUR_API_KEY
```

## First request

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

## Endpoint coverage

The current public football API covers these verified endpoint families:

* Status, timezone, countries, leagues, teams, standings, and players
* Fixtures, live scores, fixture events, lineups, and fixture statistics
* Stable NextSportsAPI public IDs for supported leagues, teams, venues, fixtures, and players

## Response model

Most endpoints return a consistent JSON envelope:

```json theme={"system"}
{
  "get": "football/standings",
  "parameters": {
    "league": "L7K9Q2R",
    "season": "2026"
  },
  "errors": [],
  "results": 1,
  "paging": {
    "current": 1,
    "total": 1
  },
  "response": []
}
```

## Production notes

Use the API Reference for exact parameters, response examples, and endpoint-specific update guidance. Cache low-change reference data such as countries, timezones, seasons, teams, and league metadata. Poll live endpoints more frequently only while matches are in progress.