predictions

Full tennis match payload (winner, total games, spread, aces, double faults, tiebreak, exact score)

Returns the full payload for a single tennis match. Player order (player_one / player_two) is as observed at data ingestion — NEVER winner-first canonicalised. All player-relative numbers (spread, exact_score classes, each player's serve projections) are aligned to that ordering. Aces and double faults are served at both levels: expected_aces / expected_double_faults (plus their entries in distributions and cdfs) stay the match totals, and player_one / player_two each carry that player's own expected_aces, expected_double_faults and the matching *_distribution / *_cdf. The total is the sum of the two per-player projections, so it means exactly what it always meant. The per-player fields are null for matches predicted before the August 2026 rollout. Once a match is played, each player also carries actual_aces and actual_double_faults, the counts that player really served, matched to the player by NAME so they can be scored directly against that player's projection and distribution. The seven sub-models (winner classifier, total-games and spread Poisson regressors, per-player aces and double-faults negative-binomial regressors, tiebreak classifier, exact_score multiclass) are independent — small cross-metric mismatches are by design. tournament.date is the tournament START day, not the specific match day. Returns 404 if the match_id is unknown.

get/v1/predictions/tennis/{match_id}

Request

  • Base URL: https://api.predixsport.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.predixsport.com/v1/predictions/tennis/{match_id}
  • Auth: none declared

Path parameters

match_idstring required

Headers

authorizationstring nullable

Response

Successful Response

match_idstring required
sport'tennis'
datestring date required

Tournament-scheduled START day, NOT the actual match day. Shared by every match of the same tournament across all rounds. Use tournament.round to gauge how far into the tournament this match falls.

seasonstring required
predicted_total_gamesinteger nullable

Rounded mean of the Poisson total-games regressor. Equivalent to round(expected_total_games) and aligned with the value shown on predixsport.com. Use expected_total_games for the un-rounded mean and distributions.total_games for the full PMF.

expected_total_gamesnumber nullable

Mean (expected value) of the Poisson total-games regressor.

predicted_resultstring nullable
expected_acesnumber nullable

Expected total aces in the match: the sum of the two per-player projections carried by player_one and player_two, with distributions.aces the convolution of their distributions. The per-player fields are null for matches predicted before the per-player rollout on that tour, and the total keeps the meaning it has always had either way.

expected_double_faultsnumber nullable

Expected total double faults in the match. Same derivation as expected_aces, on both tours.

expected_spreadnumber nullable

Expected (player_one_games - player_two_games). Sign convention follows the as-observed player order — negative means player_two is favoured.

Changes

No recorded changes to this operation across all 1 revision of this API.