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

# Daily Schedules

> Today's matches, matches by date, future matches, countries, and competitions per sport

All schedule endpoints are **per sport** — pass the sport slug (`football`, `basketball`, `cricket`, …) in the path.

## Today's Matches

```text theme={null}
GET /api/v1/{sport}/today?tz=00:00
```

| Parameter | Required | Description                                                                 |
| --------- | -------- | --------------------------------------------------------------------------- |
| `sport`   | yes      | Sport slug                                                                  |
| `tz`      | no       | Timezone offset (default `00:00`). Use `08:00` for UTC+8, `-05:00` for EST. |

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

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

```json theme={null}
{
  "success": true,
  "sport": "football",
  "count": 491,
  "cacheHit": false,
  "matches": [
    {
      "id": "ezk96i3gzz5a1kn",
      "sportId": 1,
      "matchStatus": 3,
      "matchTime": 1782612000,
      "homeScores": [1, 0, 0, 3, 2, 0, 0],
      "awayScores": [3, 2, 0, 0, 6, 0, 0],
      "homeTeam": { "id": "zjek33i08didko2", "name": "", "logo": "" },
      "awayTeam": { "id": "8vmqy9i232b4k9r", "name": "", "logo": "" },
      "competition": { "id": "p0ndkz6izigq3z1", "cid": 0 },
      "stage": 0, "groupNum": 0, "roundNum": 0
    }
  ]
}
```

<Note>
  List endpoints return **IDs only** for teams and competitions — names are empty. Call [`/match/{id}`](/api-reference/v6-aiscore/match-detail) to hydrate names, logos, venue, and animation URL.
</Note>

**Cache TTL:** 30 s

### Verified counts (sample day)

| Sport      | Matches |
| ---------- | ------- |
| Football   | 491     |
| Basketball | 106     |
| Cricket    | 20      |
| Baseball   | 74      |
| Badminton  | 657     |
| Volleyball | 22      |
| Water Polo | 23      |
| Esports    | 40      |

## Matches by Date

```text theme={null}
GET /api/v1/{sport}/date/{YYYY-MM-DD}?tz=00:00
```

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/date/2026-06-28?tz=00:00"
```

Same response shape as `/today`. **Cache TTL:** 30 s.

## Future Matches

```text theme={null}
GET /api/v1/{sport}/future
```

Returns upcoming matches beyond today (typically 18+).

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

**Cache TTL:** 30 s.

## Countries / Regions

```text theme={null}
GET /api/v1/{sport}/countries
```

Returns **191** countries and regions for football. IDs ≥ 10000 are regions (UEFA, AFC, CAF, etc.).

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

```json theme={null}
{
  "success": true,
  "countries": [
    { "id": 10001, "name": "International", "logo": "..." },
    { "id": 10002, "name": "Europe", "logo": "..." },
    { "id": 1, "name": "England", "logo": "..." },
    { "id": 2, "name": "Spain", "logo": "..." }
  ]
}
```

**Cache TTL:** 1 hour.

## Competitions for a Country

```text theme={null}
GET /api/v1/{sport}/country/{countryId}/competitions
```

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

## Hot Competitions

```text theme={null}
GET /api/v1/{sport}/competitions/hot
```

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

**Cache TTL:** 10 minutes.