V6 API Overview

Deep match data across 15 sports — schedules, incidents, odds, team & player profiles, FIFA rankings, World Cup 2026, cricket scorecards, and 3D animation widgets

V6 Deep Data API

V6 is SportsAPI Pro’s deepest match-data layer. It covers 15 sports with daily schedules, full match detail, live team stats, multi-bookmaker odds, incidents (goals, cards, VAR), lineups, H2H, commentary, cricket scorecards & ball-by-ball, global transfers, AI predictions, team & player profiles (squad, honors, injuries, salary), FIFA world rankings and complete World Cup 2026 coverage.

Key Features

• 15 sports — Football, Basketball, Tennis, Cricket, Baseball, Ice Hockey, Handball, American Football, Volleyball, Badminton, Table Tennis, Snooker, Hockey, Water Polo, Esports
• Daily schedules with sport-level filtering (up to 657 matches/day on some sports)
• Full match detail — teams, venue, referee, scores by period, 3D animation widget URL
• Live team stats — 20+ metrics (possession, shots, dangerous attacks, corners, cards)
• Multi-bookmaker odds — EU (1X2), Asian handicap, Over/Under with opening & closing lines
• Incidents — goals, cards, subs, penalties, VAR decisions with player names
• Cricket-specific — scorecards and ball-by-ball commentary
• FIFA Rankings — 211 national teams with 348 historical publication dates
• World Cup 2026 — all 104 matches, 13 group tables, full historical archive (1930-2026)
• Global transfers — 13,400+ transfers, 200 per page, with players/teams/competitions
• Player & team profiles — squad, honors, injuries, salary, market value, related entities

Base URL

V6 is reachable via the new path-based front door or the classic per-sport vanity hosts. Both shapes share the same API key, quota, and data.

New (canonical)

https://api.sportsapipro.com/v6/{sport}/...

Where {sport} is one of: football, basketball, tennis, cricket, baseball, ice-hockey, handball, american-football, volleyball, badminton, table-tennis, snooker, hockey, water-polo, esports.

Global endpoints (FIFA rankings, World Cup 2026, global transfers, H2H by team, match/team/player by ID) are sport-less — call them under any sport host, or simply use api.sportsapipro.com/v6/football/... as the canonical default.

Authentication

Every endpoint (except /health) requires your API key in the x-api-key header.

cURL — New canonical

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

Quick Start

JavaScript

const res = await fetch(
  'https://api.sportsapipro.com/v6/football/today',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const { matches } = await res.json();
console.log(`${matches.length} football matches today`);

Sport ID Map

Sport	sport_id	Slug
Football	1	football
Basketball	2	basketball
Tennis	3	tennis
Cricket	5	cricket
Baseball	6	baseball
Ice Hockey	7	ice-hockey
Handball	8	handball
American Football	9	american-football
Volleyball	10	volleyball
Badminton	11	badminton
Hockey	14	hockey
Table Tennis	17	table-tennis
Snooker	19	snooker
Water Polo	24	water-polo
Esports	100	esports

Match Status Codes

Code	Meaning
1	Not Started
2	In Progress (Live)
3	Finished
4	Postponed
5	Cancelled

Score Array Format

Both homeScores and awayScores are arrays:

[fullTime, firstHalf, secondHalf, extra1, extra2, penalties, ...]

Basketball uses quarter scores in the same array slots; cricket uses innings.

Caching

All responses are cached server-side with TTLs tuned per data type. Every response includes a cacheHit boolean. See Caching & Errors for the full TTL table.

What’s Next

• Health Check
• Sports & Counts
• Daily Schedules
• Match Detail
• World Cup 2026