Skip to content
Get a key
API reference / Stats
GET/basketball/matches/{id}/stats

Get match statistics (box score)

Returns the box score of a match from the provider's per-league stats feeds, as the data provider sends it for that sport. Basketball (NBA, NCAA, WNBA, Euroleague, ACB, Eurocup, KBL and every other league the data provider has box scores for): team_stats, player_stats (starters and bench). Hockey (NHL, KHL, Liiga, SHL, DEL, Czech Extraliga and every other league the data provider has box scores for): scoring and penalties by period, team and player stats. Baseball (MLB; the data provider sends none for KBO and NPB): starting_pitchers, stats (hitters, pitchers), events, umpires. Tennis (top matches): player, with service/return/points stats for the match and each set. American football (NFL, NCAA FBS): team_stats, passing, rushing, receiving, defensive, kicking, punting, returns, fumbles, interceptions, events. Stats are fetched from kickoff until shortly after the end (leagues without a live box-score feed: from the league season file, which gets a game after it ends and can miss games); 404 for matches without a box score.

In the plans that cover this sportPay per call without a key: $0.005 in USDC

Parameters

  • idinteger · pathrequired

    Match ID

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataobject
  • feed_match_idstring
  • match_idinteger
  • sourcestring
  • sportstring
  • statsobject
  • statusstring
  • updated_atstring
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).
404NOT_FOUNDNo record with that id.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?