# DataSportsAPI

> A real-time sports data API across 24 sports: fixtures and live scores, lineups, statistics and standings, plus teams, players and leagues, as JSON keyed by stable ids we assign ourselves, with a WebSocket that pushes live changes.

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `dsa_live_`). Keys are issued in the dashboard (https://datasportsapi.com/login/). Successful responses use a `{ data, meta? }` envelope; failures return `{ error: { code, message } }` under a matching HTTP status. Official SDKs: TypeScript (`datasportsapi` on npm), Python (`datasportsapi` on PyPI) and Go (`github.com/datasportsapi/datasportsapi-go`), plus the `dsa` CLI.

Availability: pre-launch. This documents the v2 contract; accounts, API keys and the SDK packages open with the public launch — until then, join the early-access list at https://datasportsapi.com/signup/. During the beta the Free plan allows 1,000 requests a day (100 a day after).

Contact: contact@noventra.dev · Telegram @atlaskose (https://t.me/atlaskose) · https://datasportsapi.com/contact/

## Docs

- [Overview](https://datasportsapi.com/markdown/docs.md): authentication, plans and rate limits, SDKs and CLI, errors, the WebSocket protocol, data freshness, the changelog and every endpoint
- [Data reference](https://datasportsapi.com/markdown/reference.md): every object, WebSocket frame, enum, period key, status code, position, statistic key and season statistic key

## Catalog

- [GET /v2/sports](https://datasportsapi.com/markdown/docs/api/catalog/sports-list.md): Lists all supported sports, each with the number of matches live right now. Matches the source has left open — 45 min without any change, with a kick-off further back than a match in that sport could run — do not count…
- [GET /v2/coverage](https://datasportsapi.com/markdown/docs/api/catalog/sports-coverage.md): Coverage figures for the whole API in one call, open to every plan: entity totals, each sport’s league directory and how far back its headline competitions reach.

## Live scores

- [GET /v2/livescores](https://datasportsapi.com/markdown/docs/api/livescores/list.md): Returns every live fixture across all sports, or one sport’s in-play board when ?sport= is set; each match reflects the live index, so its state is identical to the unfiltered call and to the WebSocket.

## Fixtures

- [GET /v2/fixtures](https://datasportsapi.com/markdown/docs/api/fixtures/list.md): Fixtures starting on one UTC date, for a single league, one category (country, region or tour, all its leagues at once), one country in a sport, or a whole sport paged ten leagues at a time by league rank.
- [GET /v2/fixtures/counts](https://datasportsapi.com/markdown/docs/api/fixtures/counts.md): Fixture totals for a UTC date without paging: given a sport, the date’s total and a row per category (country, region, tour) with fixture and league counts, for any date; with no sport, today’s total per sport.
- [GET /v2/fixtures/{id}](https://datasportsapi.com/markdown/docs/api/fixtures/get.md): One fixture in full: both teams, score, status, match clock, winner, league, season, round, venue, the referee (career cards per game), the two managers (homeManager / awayManager) and previousLegFixtureId.
- [GET /v2/fixtures/{id}/lineups](https://datasportsapi.com/markdown/docs/api/fixtures/lineups.md): Team lineups and formations plus unavailable players, with every player carrying a match rating and statistics.
- [GET /v2/fixtures/{id}/statistics](https://datasportsapi.com/markdown/docs/api/fixtures/statistics.md): Team statistics for the match, organised by period and by category.
- [GET /v2/fixtures/{id}/events](https://datasportsapi.com/markdown/docs/api/fixtures/events.md): The match’s incidents in chronological order, oldest first: goals, cards, substitutions, period markers and added-time announcements.
- [GET /v2/fixtures/{id}/play-by-play](https://datasportsapi.com/markdown/docs/api/fixtures/play-by-play.md): Text commentary from the source, one action per entry, oldest first, in football (cards, shots, corners, substitutions and more, by minute) and basketball (each basket, free throw, rebound, foul and turnover).
- [GET /v2/fixtures/{id}/h2h](https://datasportsapi.com/markdown/docs/api/fixtures/h2h.md): The two teams’ head-to-head record as the source tallies it, seen from this fixture’s home / away point of view, over their recent meetings (around the last ten) plus this fixture once it has finished.
- [GET /v2/fixtures/{id}/h2h/fixtures](https://datasportsapi.com/markdown/docs/api/fixtures/h2h-fixtures.md): Past and scheduled meetings of the two teams, returned as fixtures sorted by kick-off (oldest first); the fixture you asked about is excluded.
- [GET /v2/fixtures/{id}/best-players](https://datasportsapi.com/markdown/docs/api/fixtures/best-players.md): The player of the match together with the top-rated players on each team.
- [GET /v2/fixtures/{id}/momentum](https://datasportsapi.com/markdown/docs/api/fixtures/momentum.md): Attack-momentum curve (football, plus any other sport where the source draws one) with a point for every minute: positive values mean home pressure, negative values away pressure.
- [GET /v2/fixtures/{id}/win-probability](https://datasportsapi.com/markdown/docs/api/fixtures/win-probability.md): DataSportsAPI’s in-house win probabilities for a football fixture: a pre-match estimate, the live home / draw / away split and a curve with a point at kick-off, one per minute and one right after each goal.
- [GET /v2/fixtures/{id}/win-probability/source](https://datasportsapi.com/markdown/docs/api/fixtures/source-win-probability.md): In-game win probability as published by our data source (not DataSportsAPI’s model): home and away values for each minute of play.
- [GET /v2/fixtures/{id}/commentary](https://datasportsapi.com/markdown/docs/api/fixtures/commentary.md): AI-written commentary on a football fixture, oldest first by seq (newest 100): a short entry per goal, missed penalty, red card, VAR decision, period start or end, big chance and sustained swing in momentum.
- [GET /v2/fixtures/{id}/shotmap](https://datasportsapi.com/markdown/docs/api/fixtures/shotmap.md): All shots, oldest first, with outcome and expected goals; football gives expectedGoals / expectedGoalsOnTarget, pitch and goal-mouth coordinates, body part and situation, ice hockey technique and strength.
- [GET /v2/fixtures/{id}/form](https://datasportsapi.com/markdown/docs/api/fixtures/form.md): Pre-match form for both teams: recent results in this competition (oldest first), table position, the numeric table figure (points in football; wins, draws and losses in W-L / W-D-L sports) and average rating — plus eac…
- [GET /v2/fixtures/{id}/streaks](https://datasportsapi.com/markdown/docs/api/fixtures/streaks.md): Pre-match streaks: each team’s current run (wins, unbeaten, over 2.5 goals, …) plus streaks drawn from their head-to-head meetings.
- [GET /v2/fixtures/{id}/heatmap/{playerId}](https://datasportsapi.com/markdown/docs/api/fixtures/heatmap.md): A single football player’s activity map for the fixture — each recorded position sample, expressed as percentages of the pitch.
- [GET /v2/fixtures/{id}/players/{playerId}/actions](https://datasportsapi.com/markdown/docs/api/fixtures/player-actions.md): A pitch-located log of one football player’s on-ball involvement in the fixture: passes and crosses (start → end, completion, key pass, long ball), take-ons, ball carries and defensive work (tackles, interceptions, ball…
- [GET /v2/fixtures/{id}/series](https://datasportsapi.com/markdown/docs/api/fixtures/series.md): Ids of every fixture in the playoff series that contains this fixture (NBA, NHL, MLB postseason …), including this one.
- [GET /v2/fixtures/{id}/average-positions](https://datasportsapi.com/markdown/docs/api/fixtures/average-positions.md): Average position of every player during the fixture, grouped by side.
- [GET /v2/fixtures/{id}/points](https://datasportsapi.com/markdown/docs/api/fixtures/points.md): A point-by-point breakdown of the match. Tennis nests sets → games (server, winner, set score) → points; badminton, table tennis and volleyball nest sets → rallies, with the running score.
- [GET /v2/fixtures/{id}/scorecard](https://datasportsapi.com/markdown/docs/api/fixtures/scorecard.md): Full cricket scorecard by innings: total, extras, batting card (runs, balls, fours, sixes, strike rate, state, dismissal, bowler, fielder) and bowling card (overs, maidens, runs, wickets, economy, wides, no-balls).
- [GET /v2/fixtures/{id}/umpires](https://datasportsapi.com/markdown/docs/api/fixtures/umpires.md): Baseball only: the umpiring crew, giving each umpire’s name, years of experience and position, one of homePlate, firstBase, secondBase, thirdBase, leftField, rightField or other.
- [GET /v2/fixtures/{id}/weather](https://datasportsapi.com/markdown/docs/api/fixtures/weather.md): Baseball only: ballpark weather in metric units (°C, %, km/h), with the observed conditions listed before the forecast.
- [GET /v2/fixtures/{id}/games](https://datasportsapi.com/markdown/docs/api/fixtures/games.md): Esports only: the series game by game, each with status, map, start time, duration, winner and, for each side, its score and its players (role, champion / hero, kills, deaths, assists and per-title figures).
- [GET /v2/fixtures/{id}/at-bats/{atBatId}/pitches](https://datasportsapi.com/markdown/docs/api/fixtures/pitches.md): Baseball only: one at-bat pitch by pitch — type (MLB Statcast categories: four-seam fastball, sinker, cutter, changeup, curveball, slider, sweeper, …), zone, release speed, result, count and outs after each.
- [GET /v2/fixtures/{id}/highlights](https://datasportsapi.com/markdown/docs/api/fixtures/highlights.md): Match highlight videos, each with a title, its URL on the hosting platform (YouTube, X), the host name, the host’s thumbnail, a flag for the source’s main highlight and any country restrictions.

## Teams

- [GET /v2/teams/{id}](https://datasportsapi.com/markdown/docs/api/teams/get.md): Returns a team’s profile — sport, country, venue, colours, logo, gender, whether it is a club or a national team, kind (team / individual / pair), manager and founding date (foundedOn, present for roughly half of all te…
- [GET /v2/teams/{id}/fixtures](https://datasportsapi.com/markdown/docs/api/teams/fixtures.md): Returns one page of a team’s fixtures, either recent or upcoming.
- [GET /v2/teams/{id}/squad](https://datasportsapi.com/markdown/docs/api/teams/squad.md): Lists the team’s present roster, giving each player’s profile together with their contract expiry and any ongoing injury.
- [GET /v2/teams/{id}/transfers](https://datasportsapi.com/markdown/docs/api/teams/transfers.md): Arrivals and departures over roughly the past year, latest first: transfers with fees, loans and their expiry, and US-league roster transactions — signings, trades, the draft, waivers and 10-day contracts.
- [GET /v2/teams/{id}/statistics](https://datasportsapi.com/markdown/docs/api/teams/statistics.md): Season totals and averages for a team within a single league — goals for and against, shots, possession, rating, clean sheets and more.
- [GET /v2/teams/{id}/goal-distribution](https://datasportsapi.com/markdown/docs/api/teams/goal-distribution.md): Football: shows at which stage of a match a team scores and concedes across one league season, counting goals in 15-minute bands for all matches, home matches and away matches.
- [GET /v2/teams/{id}/race-career](https://datasportsapi.com/markdown/docs/api/teams/race-career.md): For race sports, the career of a driver or constructor: aggregate totals (races started, wins, podiums, poles, titles) plus one row per series season with championship position, points and figures; a driver’s row also n…
- [GET /v2/teams/{id}/races](https://datasportsapi.com/markdown/docs/api/teams/races.md): For race sports, how a driver or constructor finished in every race of one series season: a driver’s grid slot, position, points, race time and gap, or a constructor’s position, points and its drivers’ placings.
- [GET /v2/teams/{id}/statistics/seasons](https://datasportsapi.com/markdown/docs/api/teams/statistics-seasons.md): An index of the leagues and seasons with team season statistics, giving the league and season values that /v2/teams/{id}/statistics accepts along with the statistics types offered in each.
- [GET /v2/teams/{id}/top-players/seasons](https://datasportsapi.com/markdown/docs/api/teams/top-players-seasons.md): Lists the leagues and seasons where squad (player) statistics exist for the team — the inputs for /v2/teams/{id}/top-players.
- [GET /v2/teams/{id}/standings/seasons](https://datasportsapi.com/markdown/docs/api/teams/standings-seasons.md): Lists every league and season where the team appears in a standings table, ready to pass to /v2/leagues/{id}/standings.
- [GET /v2/teams/{id}/year-statistics](https://datasportsapi.com/markdown/docs/api/teams/year-statistics.md): A tennis player’s calendar year by surface, one row each: matches and wins, tournaments entered and won, aces and double faults, break points, tie-breaks, serve and return points, winners and unforced errors.
- [GET /v2/teams/{id}/grand-slams](https://datasportsapi.com/markdown/docs/api/teams/grand-slams.md): Shows, year by year, how far a tennis player went at each Grand Slam. Available since 2026-11-04.
- [GET /v2/teams/{id}/leagues](https://datasportsapi.com/markdown/docs/api/teams/leagues.md): All competitions the team takes part in now or has taken part in before: domestic league, cups, European competitions and friendly tournaments.
- [GET /v2/teams/{id}/trophies](https://datasportsapi.com/markdown/docs/api/teams/trophies.md): Everything the team has won: each competition, typed as domestic league, domestic cup, international cup or other, with a flag for major titles, the number of wins and the winning seasons, most recent first.
- [GET /v2/teams/{id}/position-history](https://datasportsapi.com/markdown/docs/api/teams/position-history.md): Tracks a team’s league position week by week through one season, starting at week 1: the position at the end of each week and the fixtures played in it.
- [GET /v2/teams/{id}/career-statistics](https://datasportsapi.com/markdown/docs/api/teams/career-statistics.md): Career-long numbers for an MMA fighter: strikes landed and absorbed per round, split by target (head, body, legs) and by position (distance, clinch, ground); accuracy and defence percentages; takedowns and submissions p…
- [GET /v2/teams/{id}/rankings](https://datasportsapi.com/markdown/docs/api/teams/rankings.md): Gives a team’s or competitor’s place in each ranking table DataSportsAPI serves: the ATP / WTA rankings and live rankings for tennis players (career high included) plus their UTR rating; the FIFA or World Rugby ranking…
- [GET /v2/teams/{id}/top-players](https://datasportsapi.com/markdown/docs/api/teams/top-players.md): Season leaderboards limited to one team’s players within a league — highest-rated players, leading scorers, top assisters and so on — paginated like the league-wide leaderboards.
- [GET /v2/teams/{id}/featured-fixture](https://datasportsapi.com/markdown/docs/api/teams/featured-fixture.md): Returns the match the source highlights for a team, which is normally its next fixture or the one it is playing right now.

## Players

- [GET /v2/players/{id}](https://datasportsapi.com/markdown/docs/api/players/get.md): A player’s profile: position and detailed positions (goalkeeper, centreBack, leftWinger, striker, …; empty array if none), team, nationality, physique, market value, contract expiry, current injury (null if fit).
- [GET /v2/players/{id}/transfers](https://datasportsapi.com/markdown/docs/api/players/transfers.md): Every move in the player’s career, most recent first, returned as the same Transfer objects that team transfer lists use.
- [GET /v2/transfers](https://datasportsapi.com/markdown/docs/api/players/transfers-list.md): A feed of the newest football transfers from all leagues, 50 per page, built from the same Transfer objects as team transfer lists.
- [GET /v2/players/{id}/seasons](https://datasportsapi.com/markdown/docs/api/players/seasons.md): Lists each league and season for which the player has statistics, together with the statistics types offered in each (overall, home, away, regularSeason, playoffs).
- [GET /v2/players/{id}/fixtures](https://datasportsapi.com/markdown/docs/api/players/fixtures.md): One page of the player’s most recent fixtures, across every team they appeared for; since 2026-10-24 each page lists the newest first.
- [GET /v2/players/{id}/statistics](https://datasportsapi.com/markdown/docs/api/players/statistics.md): Season totals and averages for a player within a single league — goals, minutes, averageRating, expected goals, passes, duels and more.
- [GET /v2/players/{id}/statistics/rankings](https://datasportsapi.com/markdown/docs/api/players/statistics-rankings.md): For every statistic, shows how the player compares with the rest of the league in one season: their value, their place (tied values share a place), how many players are tied there and how many are ranked in total.
- [GET /v2/players/{id}/penalties](https://datasportsapi.com/markdown/docs/api/players/penalties.md): Football penalty record for a player across one league season: totals scored and taken, plus each kick: its fixture, its outcome (goal, save, miss, post), its xG and where in the goal it went.
- [GET /v2/players/{id}/attributes](https://datasportsapi.com/markdown/docs/api/players/attributes.md): Attribute ratings (0–100) for a football player from the source’s scouting model: attacking, technical, tactical, defending and creativity, or for a goalkeeper saves, anticipation, ball distribution, aerial and tactical.
- [GET /v2/players/{id}/national-team](https://datasportsapi.com/markdown/docs/api/players/national-team.md): Caps, goals and debut date for every national side the player has represented, at senior and youth level.
- [GET /v2/players/{id}/career](https://datasportsapi.com/markdown/docs/api/players/career.md): The player’s career table, newest season first: statistics for each competition and season played at club and international level, either overall or split into regular season / playoffs where the league does so.
- [GET /v2/players/{id}/heatmap](https://datasportsapi.com/markdown/docs/api/players/heatmap.md): Football: a player’s match heatmaps summed over one league season to show where they were active — each point with the number of samples recorded on it — plus the matches included.
- [GET /v2/players/{id}/ratings](https://datasportsapi.com/markdown/docs/api/players/ratings.md): Match-by-match ratings for a player across one league season, oldest first, forming the points of a rating graph; each point gives the match, its kick-off, the player’s side and the opponent.

## Leagues

- [GET /v2/leagues/{id}](https://datasportsapi.com/markdown/docs/api/leagues/get.md): A league’s profile: tier (level in the national pyramid), gender, reigning champion and its title count, clubs with the most titles, the divisions above and below, and when the current season starts and ends.
- [GET /v2/leagues/{id}/seasons](https://datasportsapi.com/markdown/docs/api/leagues/seasons.md): Lists the league’s seasons, most recent first. year is the label to display, while startYear / endYear hold the numeric years — identical when a season runs within one calendar year.
- [GET /v2/leagues/{id}/champions](https://datasportsapi.com/markdown/docs/api/leagues/champions.md): Recent title winners of the league, most recent first — each entry gives the season, the year in which it finished and the champion.
- [GET /v2/leagues/{id}/venues](https://datasportsapi.com/markdown/docs/api/leagues/venues.md): Lists every venue where matches of a league season are played. Available since 2026-11-04.
- [GET /v2/leagues/{id}/calendar](https://datasportsapi.com/markdown/docs/api/leagues/calendar.md): Returns each UTC day of a league season on which fixtures are scheduled, together with the number of fixtures — handy for drawing a season calendar or linking straight to a matchday via /v2/fixtures?date=&league=.
- [GET /v2/leagues/{id}/player-of-the-season/history](https://datasportsapi.com/markdown/docs/api/leagues/player-of-the-season-history.md): A season-by-season record of the league’s player of the season — an award our data source bases on match ratings — giving the winner, his club, his average rating and his number of appearances.
- [GET /v2/leagues/{id}/teams](https://datasportsapi.com/markdown/docs/api/leagues/teams.md): Lists the participants of a single league season; works just as well for cups and other competitions that have no table.
- [GET /v2/leagues/{id}/seasons/{seasonId}](https://datasportsapi.com/markdown/docs/api/leagues/season.md): Key figures for a season — running totals such as goals, home and away wins, draws and cards — plus the teams new to the division, whether relegated into it from above or promoted from below.
- [GET /v2/leagues/{id}/standings](https://datasportsapi.com/markdown/docs/api/leagues/standings.md): League tables for a single season. With no extra parameters you get the one table marked primary for the season — the league table, or in a group stage the first group; meta.overall tells you whether it includes every t…
- [GET /v2/leagues/{id}/rounds](https://datasportsapi.com/markdown/docs/api/leagues/rounds.md): Lists every round of a season and indicates which one is current.
- [GET /v2/leagues/{id}/fixtures](https://datasportsapi.com/markdown/docs/api/leagues/fixtures.md): Returns all fixtures in a single round of a season.
- [GET /v2/leagues/{id}/top-players](https://datasportsapi.com/markdown/docs/api/leagues/top-players.md): Season leaderboards per statistic (rating, goals, assists, xG, tackles, saves and more; up to 50 players each at our data source), paged with limit players per board (10 by default), or one board via category.
- [GET /v2/leagues/{id}/top-performances](https://datasportsapi.com/markdown/docs/api/leagues/top-performances.md): Record individual match performances in a league season. For each statistic — in football goals, assists, rating, xG, key passes, saves, top speed, distance covered, …; in basketball points, rebounds, assists, …; in ice…
- [GET /v2/leagues/{id}/draft](https://datasportsapi.com/markdown/docs/api/leagues/draft.md): One round of a league’s draft (NBA, NFL or any league whose draft our data source tracks): picks in order, each with the selecting club, the club it came from by trade and the player (an id for /v2/players).
- [GET /v2/leagues/{id}/top-teams](https://datasportsapi.com/markdown/docs/api/leagues/top-teams.md): Per-statistic team leaderboards for a season — average rating, goals scored, clean sheets, possession and more — paged the same way as top-players.
- [GET /v2/leagues/{id}/player-statistics](https://datasportsapi.com/markdown/docs/api/leagues/player-statistics.md): A sortable player-statistics table for a football season: every player in the league, 20 per page, ordered by any statistic and returned with one column set — summary, attack, defense, passing, goalkeeping or other — wi…
- [GET /v2/leagues/{id}/cup-trees](https://datasportsapi.com/markdown/docs/api/leagues/cup-trees.md): A season’s knockout brackets (the knockout phase of a cup in football and other sports, a playoff tree, a tennis draw), nested as rounds, then ties, then each tie’s two participants (team, seed, winner, score), then Dat…
- [GET /v2/leagues/{id}/team-of-the-week/periods](https://datasportsapi.com/markdown/docs/api/leagues/team-of-the-week-periods.md): Every period in the season for which a team of the week exists, newest first — rounds in football and other round-based leagues, weeks in the NBA.
- [GET /v2/leagues/{id}/team-of-the-week](https://datasportsapi.com/markdown/docs/api/leagues/team-of-the-week.md): The team of the week for one round or week, set out as a line-up of the top-rated players: formation, then each player with his club, position, the rating that won him the spot and the match he earned it in.
- [GET /v2/leagues/{id}/featured-fixtures](https://datasportsapi.com/markdown/docs/api/leagues/featured-fixtures.md): Matches our data source highlights for a league, typically the standout game of the round.
- [GET /v2/leagues/{id}/player-of-the-season](https://datasportsapi.com/markdown/docs/api/leagues/player-of-the-season.md): Player of the season for a completed league season as chosen by our data source — the highest average match rating among players with enough appearances — together with his club and appearance count.
- [GET /v2/leagues/{id}/player-of-the-season/race](https://datasportsapi.com/markdown/docs/api/leagues/player-of-the-season-race.md): The ongoing contest for player of the season: the front-runners ranked by average rating, highest first.

## Discovery

- [GET /v2/rankings](https://datasportsapi.com/markdown/docs/api/discovery/rankings-list.md): Every ranking DataSportsAPI provides: FIFA (men), World Rugby (men), UEFA coefficients (countries, clubs), ATP and WTA singles (official, live), UTR ratings and padel world rankings (men and women each).
- [GET /v2/rankings/{type}](https://datasportsapi.com/markdown/docs/api/discovery/rankings-get.md): Returns one ranking, leaders first. Each row gives the current and previous position, current and previous points, the highest position reached and the number of tournaments played.
- [GET /v2/categories](https://datasportsapi.com/markdown/docs/api/discovery/categories-list.md): Returns the categories of a sport — the buckets our data source sorts leagues into: countries, regions (Europe, International), tours (ATP) and esports titles.
- [GET /v2/leagues](https://datasportsapi.com/markdown/docs/api/discovery/leagues-list.md): Directory of leagues: all leagues within a category, or all leagues of a given sport in a given country.
- [GET /v2/leagues/popular](https://datasportsapi.com/markdown/docs/api/discovery/leagues-popular.md): Our data source’s selection of a sport’s most popular leagues for a visitor from a given country, kept in the source’s order: domestic leagues and the major international competitions come first.

## Race sports

- [GET /v2/races](https://datasportsapi.com/markdown/docs/api/races/list.md): Returns every race that has a session beginning on a given UTC day, with all of each race’s sessions included.
- [GET /v2/races/{id}](https://datasportsapi.com/markdown/docs/api/races/get.md): One race in full: series, season, round, status, dates, winner, circuit (motorsport: name, city, country, lap length), host country, laps and distance, category (cycling) and its sessions in start-time order.
- [GET /v2/races/{id}/results](https://datasportsapi.com/markdown/docs/api/races/results.md): A race’s classification — in motorsport the main race session (the last of type race) with grid, pit stops, tyre stints, the set now fitted (currentTyre: compound, new or used), inPit, best laps and points.
- [GET /v2/races/{id}/laps](https://datasportsapi.com/markdown/docs/api/races/laps.md): Lap-by-lap progress of a race session: every driver’s position at the end of each lap (lap 0 is the starting grid), his tyre compound, his pit stops (recorded on the in-lap) and the lap on which he retired.
- [GET /v2/series](https://datasportsapi.com/markdown/docs/api/races/series-list.md): Lists the series under a race-sport category, such as NASCAR Cup Series, Truck Series and Xfinity under Nascar, Formula 1 under Formula 1, and Cycling Men and Cycling Women under cycling’s International.
- [GET /v2/series/{id}](https://datasportsapi.com/markdown/docs/api/races/series-get.md): Basic details of a racing series — its name, slug and sport.
- [GET /v2/series/{id}/seasons](https://datasportsapi.com/markdown/docs/api/races/series-seasons.md): Lists a series’ seasons, most recent first.
- [GET /v2/series/{id}/races](https://datasportsapi.com/markdown/docs/api/races/series-races.md): Lists the races in one season of a series. Sessions are left out here; fetch them from /v2/races/{id}.
- [GET /v2/series/{id}/standings](https://datasportsapi.com/markdown/docs/api/races/series-standings.md): A season’s championship table for drivers / riders (type=competitors, default) or teams (type=teams), listing points, wins, podiums, pole positions and fastest laps, plus races started and points-scoring races.

## Referees & managers

- [GET /v2/referees/{id}](https://datasportsapi.com/markdown/docs/api/people/referees-get.md): Referee profile with country, sport, career totals (matches plus yellow, red and second-yellow cards) and a per-competition breakdown of appearances, cards and penalties awarded.
- [GET /v2/referees/{id}/fixtures](https://datasportsapi.com/markdown/docs/api/people/referees-fixtures.md): Returns one page of matches the referee has officiated (recent) or has been assigned to (upcoming), split by the same rule as team fixtures.
- [GET /v2/managers/{id}](https://datasportsapi.com/markdown/docs/api/people/managers-get.md): Profile of a manager or head coach: country, date of birth, favoured formation, present team, career totals (games, wins, draws, losses, goals, points) and each job held with its own record, most recent first.
- [GET /v2/managers/{id}/fixtures](https://datasportsapi.com/markdown/docs/api/people/managers-fixtures.md): One page of the matches a manager has recently had or has coming up, divided by the same rule as team fixtures.

## Venues

- [GET /v2/venues/{id}](https://datasportsapi.com/markdown/docs/api/venues/get.md): One stadium or arena: its city, country, capacity, coordinates, a photo and home teams, plus per-sport totals over all matches the source holds there (match count, goals or points scored, home wins, draws).
- [GET /v2/venues/{id}/fixtures](https://datasportsapi.com/markdown/docs/api/venues/fixtures.md): Returns one page of past or scheduled matches at a venue in a single sport, split by the same rule as team fixtures.

## Search

- [GET /v2/search](https://datasportsapi.com/markdown/docs/api/search/query.md): A single search over teams (individual competitors included), players, managers, referees, leagues, fixtures, venues, racing series and races; each hit’s type names the endpoint family its id is valid for.

## Betting odds

- [GET /v2/fixtures/{id}/odds](https://datasportsapi.com/markdown/docs/api/odds/fixtures-odds.md): All markets the bookmaker offers on a fixture — result (1X2), double chance, draw no bet, winner, first to score, both teams to score, Asian handicap, handicap / point spread, goal / card / corner / points totals, the c…
- [GET /v2/fixtures/{id}/odds/winning](https://datasportsapi.com/markdown/docs/api/odds/fixtures-winning-odds.md): Winning odds set each side’s win price against the probability it implies and how often sides priced that way have really won: the source’s figures, showing at a glance if the market under- or overrates a side.
- [GET /v2/odds](https://datasportsapi.com/markdown/docs/api/odds/list.md): Returns the headline market for every fixture of a sport that the bookmaker prices on a given day — the three-way result in sports with draws, otherwise the winner.

## Tracking data

- [GET /v2/fixtures/{id}/tracking](https://datasportsapi.com/markdown/docs/api/tracking/get.md): Which tracking data a fixture holds (Enterprise only): sport, coordinate frame, final flag once the match ends, complete flag once the post-match read is in, and counts of ball frames, tracked events and timeline events.
- [GET /v2/fixtures/{id}/tracking/ball](https://datasportsapi.com/markdown/docs/api/tracking/ball.md): Ball positions recorded live for a football or tennis match, oldest first, on Enterprise only: about 14 positions per minute of football play on the 0–100 pitch, about one per tennis shot, measured in millimetres from t…
- [GET /v2/fixtures/{id}/tracking/events](https://datasportsapi.com/markdown/docs/api/tracking/events.md): Every tracked event with its position, in the order of play, on Enterprise only — football passes from start to end point, set pieces, shots, cards, fouls, substitutions and the attacking flow; tennis serves, faults and…
- [GET /v2/fixtures/{id}/tracking/timeline](https://datasportsapi.com/markdown/docs/api/tracking/timeline.md): A basketball or ice hockey match’s timeline, oldest first, on Enterprise only: every shot and where it was taken (made or missed; on target, blocked or saved), goals with the scorer and assists, penalties and their leng…

## Widgets

- [GET https://datasportsapi.com/widgets/v1.js](https://datasportsapi.com/markdown/docs/api/widgets/script.md): The script that renders widgets. Place one element wherever each widget should appear, then include the script a single time with your widget key.
- [GET https://datasportsapi.com/embed/tracker](https://datasportsapi.com/markdown/docs/api/widgets/tracker.md): Enterprise only: the live match tracker, an embed for football matches with tracking data that follows play a few seconds behind the live action — the ball and its trail, attack zones, set pieces, shots, goals, cards, V…

## Bulk exports

- [POST /v2/exports](https://datasportsapi.com/markdown/docs/api/exports/create.md): Kicks off an export of a single league season. JSON body: league (DataSportsAPI league id), season (taken from /v2/leagues/{id}/seasons) and format, one of json (the default — a single season.json containing league, sea…
- [GET /v2/exports/{id}](https://datasportsapi.com/markdown/docs/api/exports/get.md): Returns a single export. Check it every few seconds until status becomes ready (or failed); building a season takes anywhere from a few seconds (when cached) to a few minutes. files contains a download URL for each file…
- [GET /v2/exports](https://datasportsapi.com/markdown/docs/api/exports/list.md): Lists your 20 most recent exports, latest first; those that are ready come with newly issued download links.

## Webhooks

- [POST {your endpoint URL}](https://datasportsapi.com/markdown/docs/api/webhooks/event.md): Every event reaches each matching endpoint in a request of its own. For every live fixture your filters match you receive fixture.score (one side’s current score changed) and fixture.status (the match kicked off, entere…

## WebSocket

- [POST /v2/stream/ticket](https://datasportsapi.com/markdown/docs/api/websocket/stream-ticket.md): Issues a one-time ticket for opening a connection, valid for 30 seconds. The call is authenticated, rate-limited and counted against your usage exactly like any other /v2 request, and it takes no request body.
- [WS wss://api.datasportsapi.com/?ticket={ticket}](https://datasportsapi.com/markdown/docs/api/websocket/connect.md): Open a connection to the url returned with the ticket. The server first sends welcome — protocol 4 from 2026-10-23 on (protocol 3 earlier that same day, protocol 2 from 2026-10-19); channels and frame types are added wi…

## Optional

- [Everything in one file](https://datasportsapi.com/llms-full.txt): the overview, every endpoint in full and the data reference
- [OpenAPI 3.1](https://datasportsapi.com/openapi.json): the REST contract, machine-readable