# Sofascore Match Detail API

> 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): 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): Returns forecast and observed weather at the venue: temperature (°C), condition, humidity, cloud cover and wind. No data returns data: null.