> ## 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 Today's Fixtures

> Fetch fixtures for a date, league, season, team, or live status.

Use `GET /v1/football/fixtures` to build fixture lists, live score pages, match centers, and daily schedules.

## Request fixtures by date

```bash theme={"system"}
curl --request GET \
  "https://api.nextsportsapi.com/v1/football/fixtures?date=2026-08-16&timezone=Asia/Tokyo" \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Filter by league and season

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

## Get live fixtures

```bash theme={"system"}
curl --request GET \
  "https://api.nextsportsapi.com/v1/football/fixtures?live=all" \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Recommended workflow

1. Use `GET /v1/football/leagues` to discover supported league public IDs and coverage.
2. Use `GET /v1/football/fixtures?date=YYYY-MM-DD` for daily schedule pages.
3. Use `GET /v1/football/fixtures?live=all` only for live score surfaces.
4. Use `GET /v1/football/fixtures/events`, `lineups`, and `statistics` for match detail pages.

## Caching

Upcoming fixture schedules can be cached longer than live fixtures. Once a fixture is live, poll only active fixture IDs or active league IDs instead of repeatedly polling all competitions.