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

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.

New canonical

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/today?tz=00:00"

{
  "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
    }
  ]
}

List endpoints return IDs only for teams and competitions — names are empty. Call /match/{id} to hydrate names, logos, venue, and animation URL.

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

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

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

GET /api/v1/{sport}/future

Returns upcoming matches beyond today (typically 18+).

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/future"

Cache TTL: 30 s.

Countries / Regions

GET /api/v1/{sport}/countries

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

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/countries"

{
  "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

GET /api/v1/{sport}/country/{countryId}/competitions

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/country/1/competitions"

Hot Competitions

GET /api/v1/{sport}/competitions/hot

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/competitions/hot"

Cache TTL: 10 minutes.