docs / sports-data

Sports Data

Scores, schedules, teams and standings.

base /sports-data/v146 endpoints

post/sports-data/v1/scores1 credit

live + by-date scores for a sport/league

Parameter	Required
sport	required
league	required
date	optional
dates	optional

Try in playground →

post/sports-data/v1/fixtures1 credit

schedule/fixtures by date or range

Parameter	Required
sport	required
league	required
date	optional
dates	optional

Try in playground →

post/sports-data/v1/standings1 credit

league table (soccer needs season)

Parameter	Required
sport	required
league	required
season	optional

Try in playground →

post/sports-data/v1/team1 credit

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

Parameter	Required
sport	required
league	required
team_id	optional

Try in playground →

post/sports-data/v1/roster1 credit

team roster / squad with player fields

Parameter	Required
sport	required
league	required
team_id	required

Try in playground →

post/sports-data/v1/summary2 credits

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

Parameter	Required
sport	required
league	required
event_id	required

Try in playground →

post/sports-data/v1/odds1 credit

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

Parameter	Required
sport	required
league	required
event_id	optional
dates	optional

Try in playground →

post/sports-data/v1/news1 credit

league news headlines

Parameter	Required
sport	required
league	required

Try in playground →

post/sports-data/v1/search1 credit

team/player lookup (thesportsdb DB)

Parameter	Required
query	required
type	optional

Try in playground →

post/sports-data/v1/entity_search1 credit

search players/teams/tournaments/managers/referees → SofaScore ids

Parameter	Required
query	required

Try in playground →

post/sports-data/v1/live_events1 credit

all in-play events for a sport

Parameter	Required
sport	required

Try in playground →

post/sports-data/v1/scheduled_events1 credit

all scheduled events for a sport on a date

Parameter	Required
sport	required
date	required

Try in playground →

post/sports-data/v1/tournament_seasonsfree

season ids for a league (id resolution)

Parameter	Required
league	required

Try in playground →

post/sports-data/v1/match_statistics2 credits

detailed match stats (possession/shots/xG)

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/match_lineups2 credits

lineups + per-player ratings & stats

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/match_momentum1 credit

attack-momentum graph

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/match_incidents1 credit

goal/card/sub timeline

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/match_best_players1 credit

best player per team

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/match_h2h1 credit

head-to-head duel record

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/match_managers1 credit

both managers for a match

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/match_odds2 credits

multi-market odds for a match

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/match_player_heatmap1 credit

a player's touch heatmap in a match

Parameter	Required
event_id	required
player_id	required

Try in playground →

post/sports-data/v1/match_player_shotmap1 credit

a player's shotmap in a match

Parameter	Required
event_id	required
player_id	required

Try in playground →

post/sports-data/v1/match_average_positions1 credit

average player positions on the pitch

Parameter	Required
event_id	required

Try in playground →

post/sports-data/v1/player1 credit

player details (team, value, foot, contract)

Parameter	Required
player_id	required

Try in playground →

post/sports-data/v1/player_season_stats2 credits

player's season statistics in a league

Parameter	Required
player_id	required
league	required
season	optional
type	optional

Try in playground →

post/sports-data/v1/player_heatmap1 credit

player's season heatmap

Parameter	Required
player_id	required
league	required
season	optional

Try in playground →

post/sports-data/v1/player_attributes1 credit

player attribute radar (att/tech/tac/def/cre)

Parameter	Required
player_id	required

Try in playground →

post/sports-data/v1/player_transfers1 credit

player transfer history

Parameter	Required
player_id	required

Try in playground →

post/sports-data/v1/player_recent1 credit

player's recent matches

Parameter	Required
player_id	required

Try in playground →

post/sports-data/v1/team_details1 credit

team details + pregame form

Parameter	Required
team_id	required

Try in playground →

post/sports-data/v1/team_squad1 credit

full squad

Parameter	Required
team_id	required

Try in playground →

post/sports-data/v1/team_transfers1 credit

team transfers in/out

Parameter	Required
team_id	required

Try in playground →

post/sports-data/v1/team_season_stats2 credits

team's season statistics in a league

Parameter	Required
team_id	required
league	required
season	optional
type	optional

Try in playground →

post/sports-data/v1/team_form1 credit

team recent form + next/prev event

Parameter	Required
team_id	required

Try in playground →

post/sports-data/v1/team_goal_distributions1 credit

goals scored/conceded by match period

Parameter	Required
team_id	required
league	required
season	optional

Try in playground →

post/sports-data/v1/season_standings2 credits

league table (total/home/away)

Parameter	Required
league	required
season	optional
type	optional

Try in playground →

post/sports-data/v1/season_top_players2 credits

season leaders by category

Parameter	Required
league	required
season	optional
type	optional

Try in playground →

post/sports-data/v1/season_top_teams2 credits

season top teams by category

Parameter	Required
league	required
season	optional
type	optional

Try in playground →

post/sports-data/v1/team_of_week2 credits

team of the week (round or rounds list)

Parameter	Required
league	required
season	optional
round_id	optional

Try in playground →

post/sports-data/v1/power_rankings2 credits

season power rankings

Parameter	Required
league	required
season	optional
round_id	optional

Try in playground →

post/sports-data/v1/cup_tree2 credits

knockout bracket / cup tree

Parameter	Required
league	required
season	optional

Try in playground →

post/sports-data/v1/tournament_details1 credit

tournament meta (titles, tier)

Parameter	Required
league	required

Try in playground →

post/sports-data/v1/manager1 credit

manager details + career history

Parameter	Required
manager_id	required

Try in playground →

post/sports-data/v1/referee1 credit

referee details + per-tournament stats

Parameter	Required
referee_id	required

Try in playground →

post/sports-data/v1/rankings1 credit

FIFA/ATP/WTA/UEFA rankings

Parameter	Required
type	optional

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
}