Daily Schedules

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

Live Matches

Returns only in-progress matches for the sport (filtered from today’s matches by statusId 2–7). v1.6.0 enriches every match with team names, logos, slugs, and competition names — no extra /match/{id} call required.

GET /api/v1/{sport}/live?tz=00:00

Parameter	Required	Description
`sport`	yes	Sport slug
`tz`	no	Timezone offset (default `00:00`)

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

{
  "success": true,
  "sport": "football",
  "count": 4,
  "cacheHit": false,
  "matches": [
    {
      "id": "g6763i5rp5pso7r",
      "sportId": 1,
      "statusId": 5,
      "matchStatus": 2,
      "matchTime": 1782765000,
      "homeScores": [1, 0, 0, 1, 14, 1, 0],
      "awayScores": [1, 1, 0, 1, 6, 1, 0],
      "homeTeam": { "id": "r8lk2dizy4a3736", "name": "Germany", "logo": "...", "slug": "germany", "national": 1 },
      "awayTeam": { "id": "5xvkjoi65vsx793", "name": "Paraguay", "logo": "...", "slug": "paraguay", "national": 1 },
      "competition": { "id": "p0ndkz6izigq3z1", "name": "FIFA World Cup", "logo": "...", "slug": "fifa-world-cup" }
    }
  ]
}

`statusId` Reference

statusId	Meaning	Live?
1	Not Started	❌
2	1st Half	✅
3	Halftime	✅
4	2nd Half	✅
5	Extra Time	✅
6	Penalty Shootout	✅
7	Break / Suspended	✅
8	Finished	❌
9	Postponed	❌
13	Abandoned	❌

`matchStatus` (broader state)

matchStatus	Meaning
1	Not Started
2	In Progress
3	Finished
4	Postponed
8	Abandoned

Call GET /api/v1/counts first to see how many live matches exist per sport before fetching them.

Cache TTL: 30 s (shares today’s cache).

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.

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

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/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
    }
  ]
}

As of v1.6.0, list endpoints (/live, /today, /date, /future) include enriched team names, logos, slugs, and competition names directly. You only need /match/{id} for venue, animation URL, embedded incidents, and stats.

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.

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Live Matches

`statusId` Reference

`matchStatus` (broader state)

Today’s Matches

Verified counts (sample day)

Matches by Date

Future Matches

Countries / Regions

Competitions for a Country

Hot Competitions

​Live Matches

​statusId Reference

​matchStatus (broader state)

​Today’s Matches

​Verified counts (sample day)

​Matches by Date

​Future Matches

​Countries / Regions

​Competitions for a Country

​Hot Competitions

Live Matches

`statusId` Reference

`matchStatus` (broader state)

Today’s Matches

Verified counts (sample day)

Matches by Date

Future Matches

Countries / Regions

Competitions for a Country

Hot Competitions