docs / sports-data

Sports Data

Scores, schedules, teams and standings.

base /sports-data/v122 endpoints

post/sports-data/v1/scores1 credit

live + by-date scores for a sport/league

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.
date	optional	—	Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live.

Try in playground →

post/sports-data/v1/fixtures1 credit

schedule/fixtures by date or range

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.
date	optional	—	Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live.

Try in playground →

post/sports-data/v1/standings1 credit

league table (soccer needs season)

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.
season	optional	—	Season year (soccer standings need it; default current season).

Try in playground →

post/sports-data/v1/team1 credit

teams list, or one team's detail (team_id)

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.
team_id	optional	—	Team id. ESPN actions use the ESPN team id (from the team action); SofaScore team actions use the SofaScore team id.

Try in playground →

post/sports-data/v1/roster1 credit

team roster / squad with player fields

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.
team_id	required	—	Team id. ESPN actions use the ESPN team id (from the team action); SofaScore team actions use the SofaScore team id.

Try in playground →

post/sports-data/v1/summary2 credits

boxscore + player stats + PBP + H2H + win-prob + lineups

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.
event_id	required	—	Match/game id. ESPN actions use the ESPN event id; SofaScore match actions use the SofaScore event id (from scheduled_events/live_events).

Try in playground →

post/sports-data/v1/odds1 credit

moneyline/spread/total — event_id (pickcenter) or league (scheduled)

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.
event_id	optional	—	Optional event id: returns the closing line for that game; omit for all scheduled games with odds.
date	optional	—	Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live.

Try in playground →

post/sports-data/v1/news1 credit

league news headlines

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.

Try in playground →

post/sports-data/v1/search1 credit

team/player lookup (thesportsdb DB)

Parameter		Allowed / range	Description
query	required	—	Search text for a team/player/tournament/manager/referee.
type = team	optional	team · player	What to look up in the (thesportsdb) search. Defaults to team.

Try in playground →

post/sports-data/v1/injuries1 credit

current injury report grouped by team

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.

Try in playground →

post/sports-data/v1/team_schedule1 credit

a team's full schedule + results (per-team, unlike league fixtures)

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.
team_id	required	—	Team id. ESPN actions use the ESPN team id (from the team action); SofaScore team actions use the SofaScore team id.
season	optional	—	Season year (soccer standings need it; default current season).

Try in playground →

post/sports-data/v1/conferences1 credit

league conferences/divisions/groups (college conference directory)

Parameter		Allowed / range	Description
sport	required	baseball · basketball · cricket · football · hockey · soccer · tennis	Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
league	required	nba · wnba · ncaam · ncaaw · nfl · ncaaf · mlb · college-baseball · nhl · atp · wta · eng.1 · eng.2 · esp.1 · ita.1 · ger.1 · fra.1 · ned.1 · por.1 · usa.1 · mex.1 · bra.1 · uefa.champions · uefa.europa · fifa.world · ipl · bbl · sheffield-shield · county-championship · cricket-world-cup	League key (e.g. nba, nfl, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, usa.1) or a raw ESPN segment ('bra.1') / cricket series id. SofaScore actions also accept a numeric tournament id.

Try in playground →

post/sports-data/v1/tournament_seasonsfree

season ids for a league (id resolution)

Parameter		Allowed / range	Description
league	required	—	League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.

Try in playground →

post/sports-data/v1/player1 credit

player details (team, value, foot, contract)

Parameter		Allowed / range	Description
player_id	required	—	SofaScore player id (from entity_search or a lineup).

Try in playground →

post/sports-data/v1/player_transfers1 credit

player transfer history

Parameter		Allowed / range	Description
player_id	required	—	SofaScore player id (from entity_search or a lineup).

Try in playground →

post/sports-data/v1/team_details1 credit

team details + pregame form

Parameter		Allowed / range	Description
team_id	required	—	Team id. ESPN actions use the ESPN team id (from the team action); SofaScore team actions use the SofaScore team id.

Try in playground →

post/sports-data/v1/team_squad1 credit

full squad

Parameter		Allowed / range	Description
team_id	required	—	Team id. ESPN actions use the ESPN team id (from the team action); SofaScore team actions use the SofaScore team id.

Try in playground →

post/sports-data/v1/team_transfers1 credit

team transfers in/out

Parameter		Allowed / range	Description
team_id	required	—	Team id. ESPN actions use the ESPN team id (from the team action); SofaScore team actions use the SofaScore team id.

Try in playground →

post/sports-data/v1/season_standings2 credits

league table (total/home/away)

Parameter		Allowed / range	Description
league	required	—	League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
season	optional	—	Season year (soccer standings need it; default current season).
type = total	optional	total · home · away	Which standings table to return.
season_id	optional	—	Explicit SofaScore season id (skips season resolution).

Try in playground →

post/sports-data/v1/tournament_details1 credit

tournament meta (titles, tier)

Parameter		Allowed / range	Description
league	required	—	League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.

Try in playground →

post/sports-data/v1/manager1 credit

manager details + career history

Parameter		Allowed / range	Description
manager_id	required	—	SofaScore manager id (from entity_search).

Try in playground →

post/sports-data/v1/rankings1 credit

FIFA/ATP/WTA/UEFA rankings

Parameter		Allowed / range	Description
type = fifa	optional	fifa · atp · wta · uefa-countries · uefa-clubs	Ranking list. A numeric SofaScore ranking-type id is also accepted.

Try in playground →

Example request · scores

curl -X POST https://api.reefapi.com/sports-data/v1/scores \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"sport":"soccer","league":"eng.1","dates":"20260301-20260331"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}