Skip to main content
POST
Simulate Match

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
team_1
integer[]
required

Player IDs on the first team. Pass one player or two.

Required array length: 1 - 2 elements
team_2
integer[]
required

Player IDs on the opposing team. Pass as many as you sent in team_1.

Required array length: 1 - 2 elements
played_at
string<date> | null

Day the match would be played, as YYYY-MM-DD. Players are rated with the Elo they had entering that day, so you can replay a past match-up with the ratings of the time. Defaults to today.

Response

MatchSimulateResource

name
string
required

Surnames of both teams, in the form Surname/Surname - Surname/Surname. Convenience label for display.

played_at
string
required

Day the simulated match is played, as YYYY-MM-DD.

probability
object
required

Win probability for each team, as a decimal between 0 and 1. The two values always add up to 1.

favorite
null | enum<string>
required

Team favoured to win, or null when both teams are rated identically and the match is a coin flip.

Available options:
team_1,
team_2
elo_diff
integer
required

Gap between the teams' average Padel API Elo ratings, positive when team_1 is rated higher. The wider the gap, the more lopsided probability gets.

players
object
required

The players making up each side of the simulated match, with their full profiles.