# Sofascore API > Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… Page: https://docs.toolzerhub.com/reference/sofascore ## Calendar Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get races on each day of a month (v1)](https://docs.toolzerhub.com/reference/sofascore/calendar/get-sports-month-stages.md): `GET /v1/sofascore/calendar/month/stages`. Returns, for each day of month, the ids of the stages held that day. sport must be motorsport or cycling. Nothing found returns data: null. - [Get the days a season has events (v1)](https://docs.toolzerhub.com/reference/sofascore/calendar/get-sports-season-calendar.md): `GET /v1/sofascore/calendar/season`. Returns every date with events in a season and how many events fall on each, with days set by timezone_offset. Use a season id from the tournament. Nothing found returns data: null. - [Get the months a tournament played (v1)](https://docs.toolzerhub.com/reference/sofascore/calendar/get-sports-tournament-calendar.md): `GET /v1/sofascore/calendar/tournament`. Returns the months, newest first, in which a tournament had finished events. An unknown id returns data: null. - [Get tournaments per day of a month (v1)](https://docs.toolzerhub.com/reference/sofascore/calendar/get-sports-month-calendar.md): `GET /v1/sofascore/calendar/month`. Returns, for each day of month, the ids of sport tournaments with events that day. For motorsport and cycling use Get Sports Month Stages. Nothing found returns data: null. ## Categories Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Count a category's events on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/categories/get-sports-category-event-counts.md): `GET /v1/sofascore/category/event-counts`. Returns a map of tournament id to the number of events the category has on date, with the day set by timezone_offset. Nothing found returns data: null. - [Get a sport's categories (v1)](https://docs.toolzerhub.com/reference/sofascore/categories/get-sports-categories.md): `GET /v1/sofascore/sport/categories`. Returns the countries and regions sport is organised in, with id, name, slug, flag and priority. Motorsport and cycling include their series. Nothing found returns data: null. - [Get a sport's list filters (v1)](https://docs.toolzerhub.com/reference/sofascore/categories/get-sports-filters.md): `GET /v1/sofascore/sport/filters`. Returns the filters available for sport and their values, such as category type, competition level, gender and status. Nothing found returns data: null. - [Get every category, hidden ones too (v1)](https://docs.toolzerhub.com/reference/sofascore/categories/get-sports-all-categories.md): `GET /v1/sofascore/sport/categories/all`. Returns every category of sport, including ones hidden from navigation, with id, name, slug, flag and priority. Nothing found returns data: null. - [Get the best players of the last day (v1)](https://docs.toolzerhub.com/reference/sofascore/categories/get-sports-trending-players.md): `GET /v1/sofascore/sport/trending-players`. Returns the best-rated player performances of the last 24 hours in sport, each with event, player, team and statistics. Unsupported sports return data: null. - [Get the series in a category (v1)](https://docs.toolzerhub.com/reference/sofascore/categories/get-sports-category-series.md): `GET /v1/sofascore/category/series`. Returns the motorsport or cycling series of a category with id, name and slug. A category with none returns data: null. - [Get the tournaments in a category (v1)](https://docs.toolzerhub.com/reference/sofascore/categories/get-sports-category-tournaments.md): `GET /v1/sofascore/category/tournaments`. Returns the tournaments of a category, ordered by importance and grouped; tennis groups list the ones in progress. An unknown id returns data: null. ## Esports Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get player statistics for one game (v1)](https://docs.toolzerhub.com/reference/sofascore/esports/get-esports-game-lineups.md): `GET /v1/sofascore/esports-game/lineups`. Returns each player's statistics in one esports game, such as character, role, kills, deaths and assists. Nothing found returns data: null. - [Get round results for one game (v1)](https://docs.toolzerhub.com/reference/sofascore/esports/get-esports-game-rounds.md): `GET /v1/sofascore/esports-game/rounds`. Returns round-by-round results of one game, such as a Counter-Strike map, with winner, outcome and side, regulation and overtime. Nothing found returns data: null. - [Get team statistics for one game (v1)](https://docs.toolzerhub.com/reference/sofascore/esports/get-esports-game-statistics.md): `GET /v1/sofascore/esports-game/statistics`. Returns team statistics for one Dota 2 or League of Legends game, such as kills, gold, towers and dragons. Other titles return data: null. - [Get the characters each team banned (v1)](https://docs.toolzerhub.com/reference/sofascore/esports/get-esports-game-bans.md): `GET /v1/sofascore/esports-game/bans`. Returns the characters each team banned in one game, in ban order, such as League of Legends champions. Nothing found returns data: null. - [Get the maps or games of a match (v1)](https://docs.toolzerhub.com/reference/sofascore/esports/get-esports-match-games.md): `GET /v1/sofascore/event/esports-games`. Returns each game (map) of an esports match with id, status, score, winner, length and start time. Use the id with the esports game routes. Nothing found returns data: null. ## Events Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Count live and total events per sport (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-event-counts.md): `GET /v1/sofascore/events/count`. Returns, for every sport, how many events are live now and how many are on today, with the day set by timezone_offset. Nothing found returns data: null. - [Count live events per category (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-live-categories.md): `GET /v1/sofascore/events/live/categories`. Returns a map of category id to the number of sport events in play in that category. Nothing live returns an empty map. - [Count live events per tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-live-tournaments.md): `GET /v1/sofascore/events/live/tournaments`. Returns a map of sub-tournament id to the number of sport events in play in it. Nothing live returns an empty map. - [Get a compact list of upcoming events (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-upcoming-events.md): `GET /v1/sofascore/events/upcoming`. Returns id, team ids, tournament ids and start time for every event of sport on date. Only today and later dates have data; past dates return data: null. - [Get a day's events by tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-events-by-date.md): `GET /v1/sofascore/events/by-date`. Returns all events on date for one tournament or one category (country or circuit), with scores and status. An unknown id returns data: null. - [Get events added in the last 6 hours (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-new-events.md): `GET /v1/sofascore/events/new`. Returns events in snooker, darts, tennis, table tennis and esports created in the last 6 hours that start in the next 6 hours, as event, team and tournament ids. Nothing found returns data: null. - [Get every event of a sport on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-events-for-a-day.md): `GET /v1/sofascore/events/day`. Returns one page of every event of sport on date (UTC), in start order. Pages run from 1; Get Sports Day Index gives the page count. A page past the end returns an empty list. - [Get live events for a sport (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-live-events.md): `GET /v1/sofascore/events/live`. Returns every event in play for sport with live scores, status, teams and tournament. Nothing in play returns an empty list. - [Get popular events in a country (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-popular-events-by-country.md): `GET /v1/sofascore/events/popular/country`. Returns up to 8 of the most popular events of sport on date for fans in country, using that country's local day. Nothing found returns data: null. - [Get the categories playing on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-day-categories.md): `GET /v1/sofascore/events/day/categories`. Returns every category with sport events on date, with event counts, live counts and flags for available player statistics. The day follows timezone_offset. Nothing found returns data: null. - [Get the most popular events (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-popular-events.md): `GET /v1/sofascore/events/popular`. Returns the most followed events starting between 12 hours ago and 3 days ahead, for sport or across all sports when sport is omitted. Nothing found returns data: null. - [Get the most voted upcoming events (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-most-voted-events.md): `GET /v1/sofascore/events/most-voted`. Returns ids of up to 500 not-started events with the most fan votes this week, with each event's sport. Use the ids with Get Sports Event. Nothing found returns data: null. - [Get the next event with AI insights (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-next-ai-insight-event.md): `GET /v1/sofascore/events/insights/next`. Returns the next football event with AI match insights ready. Read them with Get Sports Event AI Insights after the match ends. Nothing found returns data: null. - [Get the page index for a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-day-index.md): `GET /v1/sofascore/events/day/index`. Returns how many pages Get Sports Events for a Day has for sport on date, with each page's first and last start time and the filters it covers. Nothing found returns data: null. - [Get the top event with a live stream (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-live-stream-event.md): `GET /v1/sofascore/events/live-stream`. Returns the single most popular event with a live stream for sport, preferring events in play. Nothing found returns data: null. - [Get tournaments playing on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-schedule.md): `GET /v1/sofascore/events/schedule`. Returns the tournaments with events on date for sport, 100 per page, with each one's event count. Use a tournament id with Get Sports Events by Date. - [Get tournaments with events on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-active-tournaments.md): `GET /v1/sofascore/events/day/tournaments`. Returns sub-tournament id, name and slug for every sport tournament with events on date, padded 4 hours either side of the UTC day. Nothing found returns data: null. - [Split a day's tournaments by status (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-finished-and-upcoming.md): `GET /v1/sofascore/events/day/tournaments/status`. Returns the sub-tournaments with sport events on date, split into finished and upcoming, each with event counts per UTC offset. Nothing found returns data: null. ## Match Detail Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a baseball game's umpires (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-baseball-umpires.md): `GET /v1/sofascore/event/umpires`. Returns the umpires of a baseball game with name, years of experience and position. None returns data: null. - [Get a cricket match scorecard (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-cricket-scorecard.md): `GET /v1/sofascore/event/innings`. Returns each innings of a cricket match: score, wickets, overs, extras, every batter's runs, balls and dismissal, and every bowler's figures. Other sports return data: null. - [Get a cricket match's runs per over (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-cricket-runs-per-over.md): `GET /v1/sofascore/event/momentum/cricket`. Returns cumulative runs after each over for every innings of a cricket match. Other sports, or no data, return data: null. - [Get a player's match statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-player-statistics.md): `GET /v1/sofascore/event/player/statistics`. Returns every statistic recorded for one player in the event, with team, position and rating. A player who did not play returns data: null. - [Get a player's pitches in a game (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-baseball-player-pitches.md): `GET /v1/sofascore/event/player/pitches`. Returns every pitch a player threw (kind=pitching) or faced (kind=hitting) in a baseball game. None returns data: null. - [Get a player's shot chart (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-player-shot-chart.md): `GET /v1/sofascore/event/player/shot-chart`. Returns a basketball or ice hockey player's shots in time order with coordinates and shot type. No shots returns data: null. - [Get a player's touch heatmap (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-player-heatmap.md): `GET /v1/sofascore/event/player/heatmap`. Returns a football player's touch points in the event (x, y on a 0-100 scale). No data returns data: null. - [Get a team's touch heatmap (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-team-heatmap.md): `GET /v1/sofascore/event/heatmap`. Returns a football team's touch points (x, y on a 0-100 scale), outfield and goalkeeper separately. team_id must be one of the two teams. Nothing found returns data: null. - [Get a tennis match's momentum (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-tennis-momentum.md): `GET /v1/sofascore/event/tennis-power`. Returns the momentum value of every game with set, game and break flags. Other sports return data: null; incomplete data returns an empty list. - [Get a volleyball point-by-point graph (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-volleyball-point-graph.md): `GET /v1/sofascore/event/momentum/points`. Returns the score difference after every rally, by set, for a volleyball match. Other sports return data: null. - [Get a win probability graph (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-win-probability-graph.md): `GET /v1/sofascore/event/win-probability/graph`. Returns the home win probability minute by minute, with period length and count for drawing the chart. Events without the model return data: null. - [Get AI predictions for a finished event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-ai-insights.md): `GET /v1/sofascore/event/insights`. Returns pre-match AI predictions for a finished football or tennis event: win chances, predicted score, corners, cards and a summary. None returns data: null. - [Get an event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event.md): `GET /v1/sofascore/event`. Returns one event: teams, score by period, status, tournament, season, round, venue, referee and managers. Works for every sport. An unknown id returns data: null. - [Get an event's best-rated players (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-best-players.md): `GET /v1/sofascore/event/best-players`. Returns each team's best-rated player and a top-player leaderboard with value and label. Before kickoff, or without ratings, returns data: null. - [Get an event's current win chances (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-win-probability.md): `GET /v1/sofascore/event/win-probability`. Returns current home win, draw and away win percentages for a football event. Other sports return data: null. - [Get an event's key statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-key-statistics.md): `GET /v1/sofascore/event/statistics/summary`. Returns a short list of football team statistics, such as possession, shots on target and average rating. Use Get Sports Event Statistics for the full set. Nothing found returns data: null. - [Get an event's lineups (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-lineups.md): `GET /v1/sofascore/event/lineups`. Returns both lineups with formation, starters, substitutes, missing players and each player's match statistics and rating. An event with no lineups yet returns data: null. - [Get an event's media for a country (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-media-summary.md): `GET /v1/sofascore/event/media/summary`. Returns the main media item and a short media list for an event as shown in country, with the total count. No media returns data: null. - [Get an event's momentum graph (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-momentum.md): `GET /v1/sofascore/event/momentum`. Returns per-minute graph points. In football positive values are home pressure and negative away; other sports chart the score lead. None returns data: null. - [Get an event's statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-statistics.md): `GET /v1/sofascore/event/statistics`. Returns team statistics by period, such as possession, shots, aces or rebounds, with display and numeric values. An event with no statistics yet returns data: null. - [Get an event's text commentary (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-commentary.md): `GET /v1/sofascore/event/commentary`. Returns play-by-play commentary, newest first, with text, type, period and player. An event without commentary returns data: null. - [Get an event's timeline (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-incidents.md): `GET /v1/sofascore/event/incidents`. Returns goals, cards, substitutions and period breaks in order, with minute, player, assist and running score. An event with no incidents yet returns data: null. - [Get an event's video highlights (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-highlights.md): `GET /v1/sofascore/event/highlights`. Returns video highlights of an event with title, URL, thumbnail and source. An event without highlights returns data: null. - [Get an event's videos and media (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-media.md): `GET /v1/sofascore/event/media`. Returns videos and other media for an event, key highlight first, with title, URL, thumbnail, type and country limits. No media returns data: null. - [Get both teams' form before an event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-pregame-form.md): `GET /v1/sofascore/event/form`. Returns each team's last results (W/D/L), average rating and league position before the event. Leagues and MMA only; other events return data: null. - [Get both teams' managers (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-managers.md): `GET /v1/sofascore/event/managers`. Returns the home and away managers with id, name and country. Before kickoff it falls back to each team's current manager. Nothing found returns data: null. - [Get each team's top 3 players (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-top-3-players.md): `GET /v1/sofascore/event/best-players/summary`. Returns each team's top 3 rated players, a leaderboard and, for finished football events, the player of the match. Without ratings returns data: null. - [Get every at-bat in a baseball game (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-baseball-at-bats.md): `GET /v1/sofascore/event/at-bats`. Returns every at-bat by inning with pitcher, hitter and both teams' win probability before and after. Other sports return data: null. - [Get every meeting of two teams (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-head-to-head-events.md): `GET /v1/sofascore/event/h2h/events`. Returns past and upcoming meetings of the two teams, newest first, by the event's customId. An unknown custom_id returns data: null. - [Get every point of a match (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-point-by-point.md): `GET /v1/sofascore/event/point-by-point`. Returns every point by set and game, newest first, with the running score and server, for tennis, table tennis, badminton and darts. Nothing found returns data: null. - [Get every shot in an event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-shotmap.md): `GET /v1/sofascore/event/shotmap`. Returns shots with type, situation, body part, xG, player and coordinates in football and ice hockey. player_id narrows to one player; team_id gives basketball shot areas. Nothing found returns data: null. - [Get facts about a match-up (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-facts.md): `GET /v1/sofascore/event/meta`. Returns meetings this season and last, both teams' positions and other match-up figures. No facts returns data: null. - [Get fan votes for an event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-fan-votes.md): `GET /v1/sofascore/event/votes`. Returns fan vote totals: who wins, both teams to score, first team to score and who should have won. An event without votes returns data: null. - [Get fun facts about a match-up (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-fun-facts.md): `GET /v1/sofascore/event/fun-facts`. Returns short English facts about the match-up, such as average goals at home, with the teams each refers to. None returns data: null. - [Get news about an event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-news.md): `GET /v1/sofascore/event/news`. Returns news articles about an event and its teams with headline, summary, image, link, time and publisher. No news returns data: null. - [Get official posts about an event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-tweets.md): `GET /v1/sofascore/event/tweets`. Returns X posts about the event from official club and league accounts, with text, media, time and link. No posts returns data: null. - [Get players' average positions (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-average-positions.md): `GET /v1/sofascore/event/average-positions`. Returns each football player's average pitch position (x, y on a 0-100 scale) and touch count, plus substitutions. Without tracking returns data: null. - [Get shots a goalkeeper faced (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-goalkeeper-shotmap.md): `GET /v1/sofascore/event/goalkeeper/shotmap`. Returns the shots on target a football goalkeeper faced in the event, goals and saves, with goal-mouth coordinates. None returns data: null. - [Get team streaks before an event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-team-streaks.md): `GET /v1/sofascore/event/streaks`. Returns notable streaks for both teams, such as unbeaten runs or over 2.5 goals, split into recent form and head-to-head. None returns data: null. - [Get the actions behind a rating (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-player-rating-breakdown.md): `GET /v1/sofascore/event/player/rating-breakdown`. Returns the passes, dribbles, defensive actions and carries behind a football player's rating, with coordinates and outcome. No data returns data: null. - [Get the head-to-head record (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-head-to-head.md): `GET /v1/sofascore/event/h2h`. Returns wins and draws between the two teams and between their managers. Either side can be null. Use Get Sports Head to Head Events for the meetings. - [Get the meeting closest to now (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-relevant-meeting.md): `GET /v1/sofascore/event/relevant`. Returns the meeting of two teams whose start is closest to now (live, next or most recent), by the event's customId. An unknown id returns data: null. - [Get the other games in a series (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-series.md): `GET /v1/sofascore/event/series`. Returns the ids of every event in the same series, such as both legs of a cup tie or a playoff series. Events outside a series return an empty list. - [Get the pitches of one at-bat (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-baseball-at-bat-pitches.md): `GET /v1/sofascore/event/at-bat/pitches`. Returns each pitch of an at-bat with type, speed, zone, outcome and count. An unknown at_bat_id returns data: null. - [Get the weather at an event (v1)](https://docs.toolzerhub.com/reference/sofascore/match-detail/get-sports-event-weather.md): `GET /v1/sofascore/event/weather`. Returns forecast and observed weather at the venue: temperature (°C), condition, humidity, cloud cover and wind. No data returns data: null. ## MMA Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a day's headline fights (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-headliners-by-day.md): `GET /v1/sofascore/mma/organization/headliners/day`. Returns an organization's headline fights on date, with the day set by timezone_offset. None returns data: null. - [Get a fighter's career statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-fighter-career-statistics.md): `GET /v1/sofascore/team/mma/career-statistics`. Returns a fighter's strikes by target and position, takedowns, submissions and position time, landed and received. None returns data: null. - [Get a month's headline fights (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-headliners-by-month.md): `GET /v1/sofascore/mma/organization/headliners/month`. Returns an organization's headline fights in month. None returns data: null. - [Get an MMA weight class ranking (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-weight-class-rankings.md): `GET /v1/sofascore/mma/rankings`. Returns the champion and top 15 of a weight class in every organization, or in one with tournament_id, such as UFC (19906). Nothing found returns data: null. - [Get an organization's fights (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-organization-fights.md): `GET /v1/sofascore/mma/organization/fights`. Returns an organization's fights, 30 per page, for one part of the card. A page past the end returns data: null. - [Get an organization's season fights (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-season-fights.md): `GET /v1/sofascore/mma/organization/season-fights`. Returns every fight of an organization in a season, main event first. None returns data: null. - [Get each fight night's main event (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-headline-fights.md): `GET /v1/sofascore/mma/organization/headliners`. Returns the main event of each fight night of an organization, 30 per page. A page past the end returns data: null. - [Get main-card fights around a date (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-main-events.md): `GET /v1/sofascore/mma/main-events`. Returns main-card fights from 3.5 days before to 4.5 days after date, in start order. extended reaches 8.5 days after. Nothing found returns data: null. - [Get the fights of one fight night (v1)](https://docs.toolzerhub.com/reference/sofascore/mma/get-mma-fight-night.md): `GET /v1/sofascore/mma/fight-night`. Returns every fight of one fight night, main event first, for one part of the card. Use the night's sub-tournament id. Nothing found returns data: null. ## Motorsport Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a championship table (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-standings.md): `GET /v1/sofascore/stage/standings`. Returns standings for drivers or riders (competitor) or teams (team) with position, points, wins and podiums. Nothing found returns data: null. - [Get a constructor's career totals (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-constructor-career.md): `GET /v1/sofascore/team/motorsport/team-career`. Returns a constructor's starts, wins, podiums, poles and titles, and each season's position and points. None returns data: null. - [Get a driver's career totals (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-driver-career.md): `GET /v1/sofascore/team/motorsport/driver-career`. Returns a driver's starts, wins, podiums, poles and titles, and each season's team, points and results. None returns data: null. - [Get a driver's race results (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-driver-races.md): `GET /v1/sofascore/team/motorsport/races`. Returns a driver's or constructor's races, 30 per page, with position, points, gap, grid and time. A page past the end returns data: null. - [Get a driver's races in a season (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-driver-season.md): `GET /v1/sofascore/team/motorsport/season-races`. Returns every race of a season for a driver or constructor with position, points, gap, grid and time. Use a season stage id. Nothing found returns data: null. - [Get a race, session or season (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-stage.md): `GET /v1/sofascore/stage`. Returns a stage (season, race weekend or session) with name, type, dates, status, venue and winner. An unknown id returns data: null. - [Get a series' seasons (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-series-seasons.md): `GET /v1/sofascore/stage/series/seasons`. Returns the seasons of a series, such as yearly Formula 1 seasons for 40, with name, year and dates. Nothing found returns data: null. - [Get a stage with all its substages (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-stage-tree.md): `GET /v1/sofascore/stage/extended`. Returns a stage with nested substages in one call, such as season, weekends and sessions. A top-level season returns data: null. - [Get a stage's finished races (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-finished-substages.md): `GET /v1/sofascore/stage/substages/results`. Returns only finished and running substages with results, such as a season's completed races. None returns data: null. - [Get a stage's highlights (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-highlights.md): `GET /v1/sofascore/stage/highlights`. Returns highlights of a stage and, for a race weekend, of all its sessions. Nothing found returns data: null. - [Get a stage's races or sessions (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-substages.md): `GET /v1/sofascore/stage/substages`. Returns the direct children of a stage, such as a season's race weekends or a weekend's sessions, with status, dates and winner. Nothing found returns data: null. - [Get featured races (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-featured-stages.md): `GET /v1/sofascore/stage/featured`. Returns featured race weekends for sport, such as motorsport or cycling. Nothing found returns data: null. - [Get ids of a series' near races (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-series-stage-ids.md): `GET /v1/sofascore/stage/series/recent-stage-ids`. Returns ids of a series' race weekends from a week ago through the next 7 weeks. None returns data: null. - [Get lap-by-lap positions (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-lap-chart.md): `GET /v1/sofascore/stage/laps`. Returns each driver's position and tyre on every lap of a race. No data returns data: null. - [Get media attached to a stage (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-stage-media.md): `GET /v1/sofascore/stage/media`. Returns media attached directly to a stage, without its sessions. None returns data: null. - [Get points per race for a season (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-season-races.md): `GET /v1/sofascore/stage/races`. Returns every race of a season stage with each competitor's position and points, plus season totals. Use a season stage id. Nothing found returns data: null. - [Get race weekends in the next 7 days (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-schedule.md): `GET /v1/sofascore/stage/scheduled`. Returns race weekends with sessions in the 7 days from date, each with its current or next session and session start times. Nothing found returns data: null. - [Get the seasons a driver raced (v1)](https://docs.toolzerhub.com/reference/sofascore/motorsport/get-motorsport-driver-seasons.md): `GET /v1/sofascore/team/motorsport/seasons`. Returns the seasons a driver or constructor took part in with name, year and status. None returns data: null. ## Odds Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Check if an event has more odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-event-more-odds.md): `GET /v1/sofascore/event/odds/more`. Returns hasMoreOdds: true when the provider offers markets beyond the featured ones. Otherwise data: null. Use Get Sports Event Odds for every market. - [Compare odds with real win rates (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-event-winning-odds.md): `GET /v1/sofascore/event/odds/winning`. Returns both teams' odds, the win chance they imply and how often teams at those odds actually won, in %. No data returns data: null. - [Get a day's pre-match odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-odds-for-a-day.md): `GET /v1/sofascore/odds/day`. Returns one main market, such as full-time 1X2, for every scheduled sport event on date, keyed by event id. No odds returns data: null. - [Get a driver's outright odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-motorsport-competitor-odds.md): `GET /v1/sofascore/odds/competitor`. Returns outright markets for one driver, constructor or rider in their next relevant stage. No odds returns data: null. - [Get an event's betting odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-event-odds.md): `GET /v1/sofascore/event/odds`. Returns every betting market for the event, such as full time, double chance and totals, with fractional and decimal prices and how they moved. No odds returns data: null. - [Get an event's main odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-event-featured-odds.md): `GET /v1/sofascore/event/odds/featured`. Returns an event's main markets from one provider: the default market, Asian handicap and full time, and whether more exist. No odds returns data: null. - [Get an odds provider (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-odds-provider.md): `GET /v1/sofascore/odds/provider`. Returns an odds provider by slug or id with name, slug, bet slip links and colours. An unknown provider returns data: null. - [Get boosted odds for an event (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-event-odds-boosts.md): `GET /v1/sofascore/event/odds/boosts`. Returns bet boosts the provider offers on an event before it starts, with boosted and normal prices. After kickoff, or none, returns data: null. - [Get events whose odds dropped most (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-dropping-odds.md): `GET /v1/sofascore/odds/dropping`. Returns events with the biggest odds drops, with the selection, drop percentage and full market, for sport or all sports when omitted. Nothing found returns data: null. - [Get events with one-sided history (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-lopsided-head-to-heads.md): `GET /v1/sofascore/odds/top-h2h`. Returns up to 20 events in the next 7 days where one team won at least 6 past meetings, with odds, for sport or all sports when omitted. Nothing found returns data: null. - [Get every outright market for a race (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-motorsport-outright-odds.md): `GET /v1/sofascore/odds/stage`. Returns outright markets for a season or race stage, such as winner and podium, with each competitor's price. Other stages return data: null. - [Get featured outright odds for a race (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-motorsport-featured-odds.md): `GET /v1/sofascore/odds/stage/featured`. Returns a short list of outright markets for a stage, such as winner, podium and points finish. No odds returns data: null. - [Get how an event's odds moved (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-event-odds-changes.md): `GET /v1/sofascore/event/odds/changes`. Returns the full-time 1X2 price history from one provider, oldest first, with each change. No history returns data: null. - [Get odds for a tournament's fixtures (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-tournament-odds.md): `GET /v1/sofascore/odds/tournament`. Returns full-time pre-match odds for up to 30 upcoming events of a tournament. Nothing upcoming returns data: null. - [Get odds for the most voted events (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-most-voted-odds.md): `GET /v1/sofascore/odds/top-voted`. Returns full-time pre-match odds for up to 30 of the most voted sport events starting in the next 12 hours. Nothing found returns data: null. - [Get odds matching an event's streaks (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-event-streak-odds.md): `GET /v1/sofascore/event/streaks/odds`. Returns the betting markets that match the event's team streaks for one odds provider, split into recent form and head-to-head. Nothing found returns data: null. - [Get odds that differ from win rates (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-value-odds.md): `GET /v1/sofascore/odds/winning`. Returns up to 20 events in the next 24 hours where implied and actual win rates differ most, for sport or all sports when omitted. Nothing found returns data: null. - [Get popular events with boosts (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-odds-boosts.md): `GET /v1/sofascore/odds/boosts`. Returns up to 20 popular events with bet boosts or bet builder offers and their prices, for sport or all sports when omitted. Nothing found returns data: null. - [Get popular events with odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-featured-odds-events.md): `GET /v1/sofascore/odds/featured-events`. Returns up to 5 popular sport events with odds from the provider, soonest first, widening the window up to 3 days. None returns data: null. - [Get teams on the longest streaks (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-longest-team-streaks.md): `GET /v1/sofascore/odds/streaks`. Returns up to 20 teams playing in the next 2 days with the longest current streak, for sport or all sports when omitted. Nothing found returns data: null. - [Get the single top event with odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-top-odds-event.md): `GET /v1/sofascore/odds/featured-events/top`. Returns the one top sport event with full-time odds starting between 3 hours ago and 24 hours ahead. None returns data: null. - [Get top events with odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-odds-events-by-popularity.md): `GET /v1/sofascore/odds/featured-events/popular`. Returns up to 20 sport events in the next 3 days with full-time odds, ranked by competition, fan votes and start. None returns data: null. - [Get top streaks with odds (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-high-value-streaks.md): `GET /v1/sofascore/odds/streaks/value`. Returns up to 15 recent-form and 15 head-to-head streaks for upcoming events, with odds from the provider, highest ranked first. Nothing found returns data: null. - [List odds providers in a country (v1)](https://docs.toolzerhub.com/reference/sofascore/odds/get-sports-odds-providers.md): `GET /v1/sofascore/odds/providers`. Returns the odds providers available in country with id, name, weight and bet slip links, for one display surface. Nothing found returns data: null. ## People and Venues Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a manager (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-manager.md): `GET /v1/sofascore/manager`. Returns a manager with country, date of birth, preferred formation, current team and career record. An unknown id returns data: null. - [Get a manager's career (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-manager-career.md): `GET /v1/sofascore/manager/career`. Returns each team the manager led with start and end dates and the record there. Nothing found returns data: null. - [Get a manager's events (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-manager-events.md): `GET /v1/sofascore/manager/events`. Returns events the manager led a team in, 30 per page, with the team led in each. A page past the end returns data: null. - [Get a referee (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-referee.md): `GET /v1/sofascore/referee`. Returns a referee with country, sport, debut and career totals for games and cards. An unknown id returns data: null. - [Get a referee's cards per tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-referee-statistics.md): `GET /v1/sofascore/referee/statistics`. Returns a referee's appearances, yellow cards, red cards and penalties per tournament. Nothing found returns data: null. - [Get a referee's events (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-referee-events.md): `GET /v1/sofascore/referee/events`. Returns events the referee officiated or will officiate, 30 per page. A page past the end returns data: null. - [Get a venue (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-venue.md): `GET /v1/sofascore/venue`. Returns a venue with city, country, coordinates, capacity and home teams, plus win and goal statistics for events there. An unknown id returns data: null. - [Get a venue's last and next event (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-venue-near-events.md): `GET /v1/sofascore/venue/near-events`. Returns the last finished and next upcoming event at a venue, in any sport. Either can be null. - [Get events at a venue (v1)](https://docs.toolzerhub.com/reference/sofascore/people-and-venues/get-sports-venue-events.md): `GET /v1/sofascore/venue/events`. Returns events at a venue, 30 per page, for sport or all sports. A page past the end returns data: null. ## Players Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a player (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player.md): `GET /v1/sofascore/player`. Returns a player: position, shirt number, team, country, height, preferred foot, date of birth, contract end and market value. An unknown id returns data: null. - [Get a player's attribute scores (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-attributes.md): `GET /v1/sofascore/player/attributes`. Returns attacking, technical, tactical, defending and creativity scores by year, with the average for the position. Football and American football. Nothing found returns data: null. - [Get a player's career table (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-career-statistics.md): `GET /v1/sofascore/player/statistics`. Returns the player's statistics for every competition and season. location keeps only home or away matches. Nothing found returns data: null. - [Get a player's events in a tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-tournament-events.md): `GET /v1/sofascore/player/tournament/events`. Returns the player's past events in one tournament, 30 per page, with ratings per event. A page past the end returns data: null. - [Get a player's last 12 months (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-last-12-months.md): `GET /v1/sofascore/player/last-year`. Returns a football player's timeline: match ratings, missed matches, transfers and injuries, with the competitions involved. Nothing found returns data: null. - [Get a player's last and next event (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-near-events.md): `GET /v1/sofascore/player/near-events`. Returns the player's last event and the next event of their team, with the last match rating. Neither returns data: null. - [Get a player's match ratings (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-season-ratings.md): `GET /v1/sofascore/player/season/ratings`. Returns the player's rating in each match of a season with opponent, venue side and start time. Football and basketball only. Nothing found returns data: null. - [Get a player's media for a country (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-media-summary.md): `GET /v1/sofascore/player/media/summary`. Returns up to 2 recent media items for the player as shown in country, and how many more exist. None returns data: null. - [Get a player's national team record (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-national-team.md): `GET /v1/sofascore/player/national-team`. Returns the player's senior national team appearances, goals and debut date, per team. Nothing found returns data: null. - [Get a player's past events (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-events.md): `GET /v1/sofascore/player/events`. Returns events the player played in or sat on the bench for, 30 per page, newest first, with ratings and incidents per event. A page past the end returns data: null. - [Get a player's penalty record (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-penalties.md): `GET /v1/sofascore/player/penalties`. Returns penalties a football player took with outcome, goal zone, coordinates and xG, plus scored and attempts. Pass both season fields to narrow to one season. Nothing found returns data: null. - [Get a player's season heatmap (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-season-heatmap.md): `GET /v1/sofascore/player/season/heatmap`. Returns a football player's combined touch points over a season with the matches included. None returns data: null. - [Get a player's season pitches (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-baseball-player-season-pitches.md): `GET /v1/sofascore/player/season/pitches`. Returns every pitch a baseball player threw (pitching) or faced (hitting) in a season, with type, speed, zone, count and outcome. Nothing found returns data: null. - [Get a player's season splits (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-baseball-player-splits.md): `GET /v1/sofascore/player/season/splits`. Returns a baseball player's season statistics split by situation, such as day or night, home or away and pitcher hand. None returns data: null. - [Get a player's season statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-season-statistics.md): `GET /v1/sofascore/player/season/statistics`. Returns a player's statistics for one tournament season, such as rating, goals, assists and passes, with the team. None returns data: null. - [Get a player's seasons in a tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-tournament-statistics.md): `GET /v1/sofascore/player/tournament/statistics`. Returns a player's statistics for every season of one tournament, with team and season. Nothing found returns data: null. - [Get a player's shooting by court area (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-basketball-player-shooting.md): `GET /v1/sofascore/player/season/shot-areas`. Returns a basketball player's made and missed shots per court spot over a season. None returns data: null. - [Get a player's strengths and weaknesses (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-strengths.md): `GET /v1/sofascore/player/characteristics`. Returns the player's strengths and weaknesses as ranked codes and the positions they play. No data returns empty lists. - [Get a player's teams per season (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-teams-by-season.md): `GET /v1/sofascore/player/tournament-teams`. Returns the tournaments, seasons and teams the player played for. Nothing found returns data: null. - [Get a player's transfers (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-transfer-history.md): `GET /v1/sofascore/player/transfers`. Returns the player's transfers with clubs, type, fee and date. No transfers returns data: null. - [Get a player's videos (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-media.md): `GET /v1/sofascore/player/media`. Returns highlight videos related to the player, key highlight first. None returns data: null. - [Get news about a player (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-news.md): `GET /v1/sofascore/player/news`. Returns news articles about the player with headline, summary, image, link, time and publisher. None returns data: null. - [Get penalties a goalkeeper faced (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-goalkeeper-penalties.md): `GET /v1/sofascore/player/goalkeeper/penalties`. Returns penalties a goalkeeper faced with outcome, goal zone and xG, plus goals conceded and attempts. Pass both season fields to narrow to one season. Nothing found returns data: null. - [Get seasons with player statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-statistics-seasons.md): `GET /v1/sofascore/player/statistics/seasons`. Returns the tournaments and seasons with statistics for the player, and the splits each season has. Nothing found returns data: null. - [Get the tournaments a player played (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-tournaments.md): `GET /v1/sofascore/player/tournaments`. Returns the tournaments the player has appeared in with category and sport. None returns data: null. - [Get the transfer window's moves (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-football-transfers.md): `GET /v1/sofascore/transfers`. Returns football transfers in the current window, 50 per page, newest first unless sort is set. Filter by tournament, direction, nationality, position and age. Nothing found returns data: null. - [Rank a player in each statistic (v1)](https://docs.toolzerhub.com/reference/sofascore/players/get-sports-player-season-rankings.md): `GET /v1/sofascore/player/season/rankings`. Returns where the player ranks among all players in a season for each statistic, with value, rank and number ranked. None returns data: null. ## Rankings Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a ranking table by id (v1)](https://docs.toolzerhub.com/reference/sofascore/rankings/get-sports-ranking-table.md): `GET /v1/sofascore/rankings/table`. Returns up to 500 rows of a ranking with position, points and previous position. year reads a past year of yearly rankings such as UEFA coefficients. Nothing found returns data: null. - [Get ATP, WTA, FIFA and other rankings (v1)](https://docs.toolzerhub.com/reference/sofascore/rankings/get-sports-rankings.md): `GET /v1/sofascore/rankings`. Returns a ranking table, such as ATP, WTA, FIFA or UEFA club coefficients, with rank, points, previous rank and best rank. - [Get events tied to a ranking (v1)](https://docs.toolzerhub.com/reference/sofascore/rankings/get-sports-ranking-featured-events.md): `GET /v1/sofascore/rankings/featured-events`. Returns up to 5 featured events linked to a ranking. None returns data: null. - [Get the top 4 of a sport's rankings (v1)](https://docs.toolzerhub.com/reference/sofascore/rankings/get-sports-rankings-overview.md): `GET /v1/sofascore/rankings/sport`. Returns the top 4 rows of every ranking in sport. A sport without rankings returns data: null. - [Get the top of a tournament's rankings (v1)](https://docs.toolzerhub.com/reference/sofascore/rankings/get-sports-tournament-rankings.md): `GET /v1/sofascore/rankings/tournament`. Returns the top 4 of every ranking in a tournament, such as each UFC weight class. None returns data: null. - [List every ranking (v1)](https://docs.toolzerhub.com/reference/sofascore/rankings/get-sports-ranking-types.md): `GET /v1/sofascore/rankings/types`. Returns every ranking with id, name, sport, gender and last update, such as FIFA, ATP, WTA, UEFA and UFC weight classes. Nothing found returns data: null. ## Search Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get popular picks before a search (v1)](https://docs.toolzerhub.com/reference/sofascore/search/get-sports-search-suggestions.md): `GET /v1/sofascore/search/suggestions`. Returns up to 25 popular entities of one kind to show before anything is typed, optionally for one sport. Nothing found returns data: null. - [Search events by team names (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-events.md): `GET /v1/sofascore/search/events`. Finds events by team names, such as barcelona real, 20 per page. No match returns an empty list. - [Search managers (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-managers.md): `GET /v1/sofascore/search/managers`. Finds managers by name, 20 per page. No match returns an empty list. - [Search motorsport series (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-motorsport-series.md): `GET /v1/sofascore/search/series`. Finds up to 10 motorsport series by name, such as Formula 1 or MotoGP. Nothing found returns data: null. - [Search players (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-players.md): `GET /v1/sofascore/search/players`. Finds players by name, 20 per page. No match returns an empty list. - [Search players and individual teams (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-competitors.md): `GET /v1/sofascore/search/competitors`. Finds players and one-person teams such as tennis players, 20 per page. No match returns an empty list. - [Search races and stages (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-motorsport-stages.md): `GET /v1/sofascore/search/stages`. Finds motorsport and cycling races by name, such as monza, 20 per page. No match returns an empty list. - [Search referees (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-referees.md): `GET /v1/sofascore/search/referees`. Finds referees by name, 20 per page. No match returns an empty list. - [Search stadiums and arenas (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-venues.md): `GET /v1/sofascore/search/venues`. Finds venues by name, 20 per page. No match returns an empty list. - [Search teams (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-teams.md): `GET /v1/sofascore/search/teams`. Finds teams by name. Tennis players and other individuals are under Search Sports Competitors, 20 per page. No match returns an empty list. - [Search teams, players and tournaments (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports.md): `GET /v1/sofascore/search`. Finds teams, players, tournaments and managers across every sport. Player results include their team. No match returns an empty list. - [Search tournaments (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-tournaments.md): `GET /v1/sofascore/search/tournaments`. Finds tournaments by name, such as premier, 20 per page. No match returns an empty list. - [Search tournaments with a feature (v1)](https://docs.toolzerhub.com/reference/sofascore/search/search-sports-tournaments-by-feature.md): `GET /v1/sofascore/search/tournaments/with`. Finds up to 10 tournaments by name that have a feature: a bracket, standings, power rankings, season player statistics or team of the week. Nothing found returns data: null. ## Seasons Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a season's best single games (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-best-single-games.md): `GET /v1/sofascore/tournament/season/top-players/game`. Returns the best one-match performances of a season by statistic, such as rating, goals or saves, with player, event and value. Nothing found returns data: null. - [Get a season's events at a venue (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-venue-events.md): `GET /v1/sofascore/tournament/season/venue/events`. Returns the season's events at one venue, 30 per page; span=all returns every one. A page past the end returns data: null. - [Get a season's groups (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-groups.md): `GET /v1/sofascore/tournament/season/groups`. Returns the groups of a season, each a sub-tournament id and group name. Seasons without groups return data: null. - [Get a season's knockout brackets (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-brackets.md): `GET /v1/sofascore/tournament/season/cup-trees`. Returns every knockout bracket in a season with rounds, ties, participants, scores and linked events. Seasons without knockouts return data: null. - [Get a season's most followed players (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-most-followed-players.md): `GET /v1/sofascore/tournament/season/most-followed/players`. Returns the 10 players in a season with the most followers. Nothing found returns data: null. - [Get a season's most followed teams (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-most-followed-teams.md): `GET /v1/sofascore/tournament/season/most-followed/teams`. Returns the 10 teams in a season with the most followers. Nothing found returns data: null. - [Get a season's phases and groups (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-sub-tournaments.md): `GET /v1/sofascore/tournament/season/sub-tournaments`. Returns the sub-tournaments (league phase, groups, knockout) in a season with id, name and category. Nothing found returns data: null. - [Get a season's rounds (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-rounds.md): `GET /v1/sofascore/tournament/season/rounds`. Returns every round of a season with number and, for named rounds, name, slug and prefix, plus the current round. Leagues without rounds return data: null. - [Get a season's statistics splits (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-statistics-types.md): `GET /v1/sofascore/tournament/season/statistics/types`. Returns the statistics splits a season has, such as overall, home, away or regularSeason, for player or team statistics. Nothing found returns data: null. - [Get a season's top players (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-leaders.md): `GET /v1/sofascore/tournament/season/top-players`. Returns season leaders grouped by statistic, such as rating, goals, assists and xG, each with player, team and value. position filters by role. Nothing found returns data: null. - [Get a season's top teams (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-top-teams.md): `GET /v1/sofascore/tournament/season/top-teams`. Returns the leading teams of a season grouped by statistic, such as goals scored or clean sheets, with each value. Nothing found returns data: null. - [Get a season's totals (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-facts.md): `GET /v1/sofascore/tournament/season/info`. Returns season totals: goals, home and away wins, draws, cards, competitor count, hosts and promoted or relegated teams. None returns data: null. - [Get a sortable player stats table (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-player-table.md): `GET /v1/sofascore/tournament/season/statistics`. Returns a page of player season statistics sorted by order, with one column group. Teams and filters come from Get Sports Season Statistics Info. Nothing found returns data: null. - [Get a team's events in a season (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-team-events.md): `GET /v1/sofascore/tournament/season/team/events`. Returns one team's results or fixtures in a tournament season, 30 per page. A page past the end returns data: null. - [Get every player in a season (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-players.md): `GET /v1/sofascore/tournament/season/players`. Returns up to 2,500 players who played in a football season with player id, name, position and team. Other sports return data: null. - [Get every team's last 5 events (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-team-form.md): `GET /v1/sofascore/tournament/season/form`. Returns each team's last 5 events in a season, grouped by sub-tournament then team, for a form guide beside the standings. Nothing found returns data: null. - [Get league shooting by court area (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-basketball-league-shooting.md): `GET /v1/sofascore/tournament/season/shot-areas`. Returns the league's average shooting percentage and five percentiles per court area, to compare a player, team or game. Basketball only. Nothing found returns data: null. - [Get the events of one round (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-round-events.md): `GET /v1/sofascore/tournament/season/round/events`. Returns every event of a round (matchday). Pass slug and prefix for named rounds from Get Sports Season Rounds; span keeps only results or fixtures. Nothing found returns data: null. - [Get the player of the season (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-player-of-the-season.md): `GET /v1/sofascore/tournament/season/player-of-the-season`. Returns the best-rated player of a football or basketball season with team and statistics. Other sports return data: null. - [Get the player table's filters (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-statistics-info.md): `GET /v1/sofascore/tournament/season/statistics/info`. Returns the teams, nationalities and statistic groups for Get Sports Season Player Table, and whether home and away splits exist. Nothing found returns data: null. - [Get the power rankings for a round (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-power-rankings.md): `GET /v1/sofascore/tournament/season/power-rankings`. Returns each team's power ranking for one round with rank, points and change since the previous round. Nothing found returns data: null. - [Get the team of the season (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-team-of-the-season.md): `GET /v1/sofascore/tournament/season/team-of-the-season`. Returns the team of the season: formation and players with team, rating and lineup order. None returns data: null. - [Get the team of the week (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-team-of-the-week.md): `GET /v1/sofascore/tournament/season/team-of-the-week`. Returns the formation and players of one team of the week, each with team, rating and event. An unknown period returns data: null. - [Get the teams in a season (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-teams.md): `GET /v1/sofascore/tournament/season/teams`. Returns every team taking part in a season. Club friendlies return an empty list. - [Get the teams in one group (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-sub-tournament-teams.md): `GET /v1/sofascore/tournament/sub-tournament/teams`. Returns the teams that played in one sub-tournament, such as a group, in a season. Nothing found returns data: null. - [Get the venues of a season (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-season-venues.md): `GET /v1/sofascore/tournament/season/venues`. Returns the venues used in a season with id, name, city and capacity. Nothing found returns data: null. - [List power ranking rounds (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-power-ranking-rounds.md): `GET /v1/sofascore/tournament/season/power-rankings/rounds`. Returns the power ranking rounds of a season, newest first, with id and matching round. None returns data: null. - [List team of the week periods (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-team-of-the-week-periods.md): `GET /v1/sofascore/tournament/season/team-of-the-week/periods`. Returns team of the week periods, newest first, with id, type, name and round. Use the id with Get Sports Team of the Week. Nothing found returns data: null. - [List team of the week rounds (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-team-of-the-week-rounds.md): `GET /v1/sofascore/tournament/season/team-of-the-week/rounds`. Returns the rounds of a season that have a team of the week. None returns data: null. - [Rank a team's players by rating (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-team-player-ratings.md): `GET /v1/sofascore/tournament/season/top-ratings`. Returns one team's players ranked by average rating in a season, with appearances. No ratings returns data: null. - [Track a team's league position (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-team-position-graph.md): `GET /v1/sofascore/tournament/season/position-graph`. Returns a team's league position week by week with each week's dates and events, for a position chart. No data returns data: null. - [Track a team's power ranking (v1)](https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-team-power-ranking-history.md): `GET /v1/sofascore/tournament/season/power-rankings/team`. Returns a team's power ranking after each round of a season with that round's event. No data returns data: null. ## Sub-Tournaments Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a knockout bracket (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-bracket.md): `GET /v1/sofascore/sub-tournament/season/cup-tree`. Returns a knockout stage's bracket for a season: rounds, ties, participants, scores and events. Use the knockout stage's sub-tournament id. Nothing found returns data: null. - [Get a sub-tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament.md): `GET /v1/sofascore/sub-tournament`. Returns a sub-tournament (a league phase, group or knockout stage) with name, slug, category and the tournament it belongs to. An unknown id returns data: null. - [Get a sub-tournament's events (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-events.md): `GET /v1/sofascore/sub-tournament/events`. Returns results or fixtures of a sub-tournament across seasons, 30 per page. A page past the end returns data: null. - [Get a sub-tournament's events on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-day.md): `GET /v1/sofascore/sub-tournament/events/day`. Returns a sub-tournament's events on date in start order, covering that date in every time zone. No events returns data: null. - [Get a sub-tournament's rounds (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-rounds.md): `GET /v1/sofascore/sub-tournament/season/rounds`. Returns the rounds of a sub-tournament season with number, name, slug and start, plus the current round. Nothing found returns data: null. - [Get a sub-tournament's seasons (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-seasons.md): `GET /v1/sofascore/sub-tournament/seasons`. Returns the seasons in which the sub-tournament has events, newest first, with id, name and year. Nothing found returns data: null. - [Get a sub-tournament's table (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-standings.md): `GET /v1/sofascore/sub-tournament/season/standings`. Returns the standings of one sub-tournament, such as a single group, for a season. No standings returns data: null. - [Get a sub-tournament's videos (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-media.md): `GET /v1/sofascore/sub-tournament/media`. Returns up to 10 of the latest highlight videos of a sub-tournament. None returns data: null. - [Get a team's events in a group (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-team-events.md): `GET /v1/sofascore/sub-tournament/season/team/events`. Returns one team's events in a sub-tournament season, 30 per page; span=all returns all. A page past the end returns data: null. - [Get each team's last 5 events (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-form.md): `GET /v1/sofascore/sub-tournament/season/form`. Returns each team's last 5 events in a sub-tournament season, keyed by team id. No data returns data: null. - [Get one round of a sub-tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-round.md): `GET /v1/sofascore/sub-tournament/season/round/events`. Returns every event of a round. Pass slug for named rounds such as the final; span keeps only results or fixtures. Nothing found returns data: null. - [Get one season's events (v1)](https://docs.toolzerhub.com/reference/sofascore/sub-tournaments/get-sports-sub-tournament-season-events.md): `GET /v1/sofascore/sub-tournament/season/events`. Returns a sub-tournament's results or fixtures in a season, 30 per page; span=all returns the whole season. A page past the end returns data: null. ## Teams Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Find head-to-head data for two teams (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-head-to-head-seasons.md): `GET /v1/sofascore/team/h2h/discovery`. Returns the tournaments and years in which two teams have head-to-head data. None returns data: null. - [Get a player to watch per fixture (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-featured-players.md): `GET /v1/sofascore/team/featured-players`. Returns a featured player for each upcoming event, keyed by event id: the best performer of the last match who is not missing. Nothing found returns data: null. - [Get a team (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team.md): `GET /v1/sofascore/team`. Returns a team, or a player in tennis and MMA: country, manager, venue, founding date, main tournament and recent form. An unknown id returns data: null. - [Get a team's best players in a season (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-season-leaders.md): `GET /v1/sofascore/team/season/top-players`. Returns the team's leaders grouped by statistic, such as rating, goals and assists, each a ranked list. None returns data: null. - [Get a team's events in a tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-tournament-events.md): `GET /v1/sofascore/team/tournament/events`. Returns the team's results or fixtures in one tournament, 30 per page. A page past the end returns data: null. - [Get a team's featured event (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-featured-event.md): `GET /v1/sofascore/team/featured-event`. Returns the team's live event, or else the most relevant of its last and next events. A team with no events returns data: null. - [Get a team's full transfer history (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-transfer-history.md): `GET /v1/sofascore/team/transfers/history`. Returns the team's transfer history, 25 per page, with player, clubs, type, fee and date. A page past the end returns data: null. - [Get a team's last and next event (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-near-events.md): `GET /v1/sofascore/team/near-events`. Returns the team's most recent event and next scheduled event with full details. Either can be null. - [Get a team's media for a country (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-media-summary.md): `GET /v1/sofascore/team/media/summary`. Returns up to 2 recent media items for the team as shown in country, and the total count. None returns data: null. - [Get a team's official posts (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-tweets.md): `GET /v1/sofascore/team/tweets`. Returns recent posts from the team's official X account with text, media, time and link. None returns data: null. - [Get a team's results or fixtures (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-events.md): `GET /v1/sofascore/team/events`. Returns a team's results (type=last) or fixtures (type=next) across all competitions, 30 per page. An unknown id returns data: null. - [Get a team's season heatmap (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-season-heatmap.md): `GET /v1/sofascore/team/season/heatmap`. Returns a football team's combined season touch points, the matches included and their events. None returns data: null. - [Get a team's season statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-season-statistics.md): `GET /v1/sofascore/team/season/statistics`. Returns a team's season totals, such as goals, shots, possession, passes and cards for football. None returns data: null. - [Get a team's squad (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-squad.md): `GET /v1/sofascore/team/players`. Returns the current squad with position, shirt number, country, date of birth and market value where known, split into foreign and national players. Nothing found returns data: null. - [Get a team's transfers this year (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-transfers.md): `GET /v1/sofascore/team/transfers`. Returns the team's transfers in and out over the last 12 months with player, clubs, type, fee and date. None returns data: null. - [Get a team's trophies (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-trophies.md): `GET /v1/sofascore/team/achievements`. Returns a football or basketball team's trophy count and titles per competition. Other sports, or no trophies, return data: null. - [Get a team's videos (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-media.md): `GET /v1/sofascore/team/media`. Returns highlight videos and media from the team's events. None returns data: null. - [Get every player's season statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-player-statistics.md): `GET /v1/sofascore/team/season/player-statistics`. Returns season statistics for every player of the team, such as goals, assists and rating, and whether each played enough to rank. Nothing found returns data: null. - [Get every ranking a team is in (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-rankings.md): `GET /v1/sofascore/team/rankings`. Returns each ranking that includes the team or player, such as ATP or FIFA, with current position and points. Unranked returns data: null. - [Get every tournament a team played (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-all-tournaments.md): `GET /v1/sofascore/team/tournaments/all`. Returns every tournament the team has played in, newest first. None returns data: null. - [Get ids of a team's near events (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-event-ids.md): `GET /v1/sofascore/team/recent-event-ids`. Returns ids of the team's events from the last week through the next 7 weeks. None returns data: null. - [Get news about a team (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-news.md): `GET /v1/sofascore/team/news`. Returns up to 30 news articles about the team with headline, summary, image, link, time and publisher. None returns data: null. - [Get recent events with lineups (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-events-with-lineups.md): `GET /v1/sofascore/team/events/with-lineups`. Returns up to 3 recent events with known lineups and formations, including events in the next 7 days whose lineups are out. Nothing found returns data: null. - [Get recent events with momentum (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-events-with-momentum.md): `GET /v1/sofascore/team/events/with-momentum`. Returns up to 3 recent events with a momentum graph. Use the ids with Get Sports Event Momentum. Nothing found returns data: null. - [Get RSS feeds about a team (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-news-feeds.md): `GET /v1/sofascore/team/rss`. Returns RSS feed URLs with news about the team, keyed by country code. None returns data: null. - [Get seasons with a team in a table (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-standings-seasons.md): `GET /v1/sofascore/team/standings/seasons`. Returns the tournaments and seasons in which the team has standings, for Get Sports Standings. None returns data: null. - [Get seasons with team statistics (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-statistics-seasons.md): `GET /v1/sofascore/team/statistics/seasons`. Returns the tournaments and seasons with team or player statistics for the team, and the splits each season has. Nothing found returns data: null. - [Get the tournaments a team plays in (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-tournaments.md): `GET /v1/sofascore/team/tournaments`. Returns the tournaments the team is in now, such as league, cup and continental competitions. Nothing found returns data: null. - [Get when a team scores and concedes (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-goal-times.md): `GET /v1/sofascore/team/season/goal-times`. Returns goals scored and conceded per 15-minute period in a season, overall, home and away. None returns data: null. - [Rank a team in each statistic (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-season-ranks.md): `GET /v1/sofascore/team/season/ranks`. Returns where the team ranks in the league for each statistic, in total and per game, with the team and match count. Nothing found returns data: null. - [Score a team's last 10 events (v1)](https://docs.toolzerhub.com/reference/sofascore/teams/get-sports-team-performance.md): `GET /v1/sofascore/team/performance`. Returns the team's last finished events with a score from -5 to 5 for each, weighted by how expected the result was. Nothing found returns data: null. ## Tennis Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a player's Grand Slam results (v1)](https://docs.toolzerhub.com/reference/sofascore/tennis/get-tennis-grand-slam-results.md): `GET /v1/sofascore/team/tennis/grand-slams`. Returns a tennis player's round reached at each Grand Slam over the last five years. Non-tennis teams return data: null. - [Get a player's recent tournaments (v1)](https://docs.toolzerhub.com/reference/sofascore/tennis/get-tennis-recent-tournaments.md): `GET /v1/sofascore/team/tennis/recent-tournaments`. Returns the tournaments a tennis player played recently with the round reached and whether they won. Non-tennis teams return data: null. - [Get a player's statistics for a year (v1)](https://docs.toolzerhub.com/reference/sofascore/tennis/get-tennis-year-statistics.md): `GET /v1/sofascore/team/tennis/year-statistics`. Returns a tennis player's year by surface: matches, wins, titles, aces, double faults, serve and break points and tiebreaks. None returns data: null. - [Get a tennis player's matches (v1)](https://docs.toolzerhub.com/reference/sofascore/tennis/get-tennis-player-events.md): `GET /v1/sofascore/team/tennis/events`. Returns a tennis player's or pair's matches, 30 per page, filtered to singles, doubles or all. A page past the end returns data: null. - [Get how far a player got (v1)](https://docs.toolzerhub.com/reference/sofascore/tennis/get-tennis-tournament-result.md): `GET /v1/sofascore/team/tennis/season-result`. Returns the round a tennis player reached in one tournament season and whether they won it. None returns data: null. ## Tournaments Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a draft year's prospects (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-draft-prospects.md): `GET /v1/sofascore/tournament/draft/prospects`. Returns draft prospects for a year with name, position, college or team and linked player. kind=top returns top prospects only. No draft returns data: null. - [Get a season's draft (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-draft.md): `GET /v1/sofascore/tournament/draft`. Returns NBA or NFL draft details for a season: year, dates, status, rounds and lottery. Other tournaments return data: null. - [Get a season's results or fixtures (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-events.md): `GET /v1/sofascore/tournament/events`. Returns a season's results (type=last) or fixtures (type=next), 30 per page, with scores and status. An unknown season returns data: null. - [Get a season's standings (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-standings.md): `GET /v1/sofascore/tournament/standings`. Returns the league table, or each group's table, with played, won, drawn, lost, goals and points. A season without standings, such as a knockout cup, returns data: null. - [Get a tournament and its seasons (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament.md): `GET /v1/sofascore/tournament`. Returns a tournament with its category, title holder, most titles, current season dates and every season id. An unknown id returns data: null. - [Get a tournament's events on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-day.md): `GET /v1/sofascore/tournament/events/day`. Returns all of a tournament's events on date, with the day set by timezone_offset. No events returns data: null. - [Get a tournament's events, any season (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-events.md): `GET /v1/sofascore/tournament/events/all-seasons`. Returns results (last), fixtures (next) or live events of a tournament, 30 per page, ignoring seasons. Use it for organizations such as MMA promotions. Nothing found returns data: null. - [Get a tournament's fan player vote (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-player-vote-ranking.md): `GET /v1/sofascore/tournament/player-votes`. Returns the current fan vote ranking of players with vote counts. A tournament without a vote returns data: null. - [Get a tournament's featured event (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-featured-event.md): `GET /v1/sofascore/tournament/featured-events`. Returns the tournament's featured event with full details. None returns data: null. - [Get a tournament's past winners (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-winners.md): `GET /v1/sofascore/tournament/winners`. Returns the winner of each season, newest first, 10 per page. A page past the end returns data: null. - [Get a tournament's videos (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-media.md): `GET /v1/sofascore/tournament/media`. Returns highlight videos and media for a tournament with title, URL, thumbnail and type. None returns data: null. - [Get facts about a tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-facts.md): `GET /v1/sofascore/tournament/meta`. Returns other names, organiser, team and round counts, frequency, first winner, most titles, top scorers and biggest wins. None returns data: null. - [Get FIFA World Cup key players (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-world-cup-key-players.md): `GET /v1/sofascore/tournament/world-cup/key-players`. Returns the key players of the FIFA World Cup with each one's rating and the qualifying competition it comes from. Nothing found returns data: null. - [Get historical season comparisons (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-season-comparisons.md): `GET /v1/sofascore/tournament/comparisons`. Returns preset comparisons of two teams or two players across seasons, with each one's season statistics. None returns data: null. - [Get ids of recent and next events (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-event-ids.md): `GET /v1/sofascore/tournament/recent-event-ids`. Returns ids of the tournament's events from the last week through the next 7 weeks. None returns data: null. - [Get the picks of a draft round (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-draft-picks.md): `GET /v1/sofascore/tournament/draft/picks`. Returns the picks of one draft round with overall pick, pick in round, team and prospect, plus teams without a pick. Nothing found returns data: null. - [Get trades and injuries in a league (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-basketball-player-news.md): `GET /v1/sofascore/tournament/player-news`. Returns the latest trades and injuries in a basketball league such as the NBA (132). None returns data: null. - [Get transfers in and out of a league (v1)](https://docs.toolzerhub.com/reference/sofascore/tournaments/get-sports-tournament-transfers.md): `GET /v1/sofascore/tournament/transfers`. Returns transfers into and out of the tournament's teams, 25 per page, with player, clubs, date, fee and type. A page past the end returns data: null. ## TV Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season… - [Get a TV channel's schedule (v1)](https://docs.toolzerhub.com/reference/sofascore/tv/get-sports-tv-channel-schedule.md): `GET /v1/sofascore/tv/channel/schedule`. Returns a channel's upcoming and live events and stages that it is confirmed to broadcast. Nothing found returns data: null. - [Get votes for a channel's broadcast (v1)](https://docs.toolzerhub.com/reference/sofascore/tv/get-sports-tv-channel-votes.md): `GET /v1/sofascore/tv/channel/votes`. Returns fan up and down votes confirming a channel shows an event or stage. Unapproved channels return data: null. - [Get who broadcasts an event (v1)](https://docs.toolzerhub.com/reference/sofascore/tv/get-sports-event-broadcasts.md): `GET /v1/sofascore/tv/broadcasts`. Returns, per country code, the ids of TV channels showing an event or stage. Look up names with Get Sports TV Channels. None returns data: null. - [List a country's TV channels (v1)](https://docs.toolzerhub.com/reference/sofascore/tv/get-sports-tv-channels.md): `GET /v1/sofascore/tv/channels`. Returns every TV channel in country, alphabetically, with id, name and link. popular=true orders by upcoming broadcasts. Nothing found returns data: null.