Data coverage

API data guide

Understand the breadth of SportsDatabase coverage, freshness guarantees, and schema resources. Use this guide to plan your ingestion strategy and communicate expectations with stakeholders.

Explore API reference Review testing guide

Core taxonomy

Nightly sync from SportsData.db imports with steward moderation overlays

Sports, leagues, teams, players, venues, and referees with canonical IDs
Cross-league franchise hierarchies and historical relocations
Rich metadata: founding year, colors, logos, alternative spellings

Schedules & results

Live event delta feeds (≤90s) for paid tiers, nightly for free tier

Season calendars with kickoff times normalized to UTC and local time zones
Event status tracking (scheduled, live, final) with score progression and attendance
Referee crews, broadcasters, and streaming availability flags

Statistics & honours

Post-event backfill within 15 minutes, leaderboard recalcs hourly

Per-event box scores across scoring summaries, player minutes, and advanced metrics
Cumulative leaderboards aligned to league conventions
Honours & trophies with season span, rank, and official naming

Freshness by tier

Every dataset ships with explicit refresh SLAs. Paid tiers receive prioritized pipelines and steward escalations when anomalies trigger alerts.

Dataset	Free	Pro	Enterprise
Taxonomy	Nightly	Nightly + steward hotfixes	On-demand backfills
Schedules	Nightly	Hourly	≤5 minutes
Live scores	Unavailable	90-second lag	30-second lag
Stats & box scores	4 hours	60 minutes	15 minutes
Honours & awards	Weekly	Daily	Daily with steward alerts

Quality guardrails

Data flows through multiple enrichment and validation stages. Steward reviewers triage anomalies and escalate urgent fixes to engineering with clear SLAs.

Schema stability

Breaking field removals require 60-day notice. Additive changes ship behind preview headers and are announced via changelog.

Attribution

All datasets trace back to steward-sourced evidence. We version provenance documents and make them available on request.

Quality checks

Automated validation gates enforce referential integrity, enum ranges, and duplicate detection before data is promoted.

Dataset directory

Common resources and sample endpoints to help you explore coverage quickly. Each response includes catalog IDs to power downstream joins.

Sports

Key fields

catalogId, slug, name, governingBody, regions

View sample endpoint

Leagues

Key fields

catalogId, sportId, slug, name, founded, tier, country

View sample endpoint

Teams

Key fields

catalogId, leagueId, slug, name, stadium, stripes, colors

View sample endpoint

Players

Key fields

catalogId, teamId, slug, firstName, lastName, nationality, position, birthDate

View sample endpoint

Schema resources

Align your internal models with ours. These resources stay in lockstep with production deployments.

OpenAPI specification

Download the machine-readable spec used to generate client SDKs and portal docs.

View OpenAPI repo

TypeScript types

Install the @sportsdb/types package to leverage generated interfaces and enums in your apps.

Install from npm

Prisma schema

Inspect the canonical database schema powering Atlas. Useful for designing warehouse joins and ETL pipelines.

Browse Prisma schema

Need deeper access?

Enterprise partners can request bespoke datasets, ingestion jobs, and SLAs. Our data engineering team will scope custom feeds and coordinate delivery windows.

Compare tiers Contact data engineering

Frequently asked questions

Do you support historical backfills?: Yes. Enterprise contacts can request historical exports dating back to the 1950s for major leagues, delivered as CSV or Parquet with signed URLs.
How are data corrections handled?: Stewards submit corrections with evidence. Once approved, we issue changefeed notices and revalidate affected caches within minutes.
Can I mirror the schema internally?: Absolutely. Use the Prisma schema and OpenAPI spec to align datatypes. We also provide nightly dumps for staging environments.