AI PadelAPI documentation Back to site

API reference

The reference is generated from the live cloud API description (OpenAPI) and checked against the code. App and club panel sections that are not meant for integrations are not included.

Swagger: integrations and the partner API · Download the OpenAPI description (openapi.json)

Base URL: https://your-server/api · 65 methods

1C integration 4

Club payments pushed from 1C (Russian accounting system) to player wallets. Access: the 1C token in the X-1C-Token header.

MethodTitlePathAccess
GETPing and token check/v1/integrations/1c/ping1C token
POSTImport payments/v1/integrations/1c/payments1C token
GETList payments (reconciliation)/v1/integrations/1c/payments1C token
POSTRe-match unmatched payments/v1/integrations/1c/payments/retry1C token

MATCHi integration 1

MATCHi court booking events: booking created, moved, cancelled. Access: the MATCHi signature in the x-matchi-signature header.

MethodTitlePathAccess
POSTMATCHi court booking event/v1/integrations/matchi/{club_id}MATCHi signature

Court server: data ingest 13

Match results, stats, movement, clips, live score, americano, tournament bracket, levels and player passes. Access: the club token in X-Club-Token.

MethodTitlePathAccess
POSTMatch result from the court/v1/ingest/match-resultClub token
POSTMatch stats/v1/ingest/match-statsClub token
POSTPlayer movement/v1/ingest/match-movementClub token
POSTClip metadata/v1/ingest/clipsClub token
PUTUpload clip file/v1/ingest/clips/fileClub token
POSTPlayer highlight during the match/v1/ingest/player-clipClub token
POSTLive court score/v1/ingest/liveClub token
GETCurrent americano game on a court/v1/ingest/quick-gamesClub token
POSTAmericano game score from the court/v1/ingest/quick-games/{game_id}/scoreClub token
GETBracket match on a court/v1/ingest/bracketClub token
POSTBracket match result from the court/v1/ingest/bracket/{match_id}/resultClub token
GETPlayer levels for the terminal/v1/ingest/levelsClub token
POSTCheck a player pass in the cloud/v1/ingest/player-passClub token

Court server: computer vision 6

Rallies with ball trajectory, match summary, camera health and court bookings. Writes use the club token; reads accept the club token or a player token.

MethodTitlePathAccess
POSTRally/v1/cv/rallyClub token
POSTMatch summary/v1/cv/match-summaryClub token
POSTCourt health/v1/cv/healthClub token
GETMatch computer vision data/v1/cv/match/{match_id}Club token or player token
GETLatest court health/v1/cv/court/{court}/healthClub token or player token
GETCourt bookings now/v1/cv/court-bookingsClub token

Court server license 1

Signed license for a club court server machine. Access: the club token.

MethodTitlePathAccess
POSTIssue a court server license/v1/license/courtClub token

Live score 1

Score of matches in progress on the club courts, for scoreboards, websites and apps. Public method.

MethodTitlePathAccess
GETLive scores of club courts/v1/live/{club_id}Public

Leads 1

Requests from a website, an ad or the club front desk. Public method.

MethodTitlePathAccess
POSTCreate a lead/v1/leadsPublic

Clubs and slots 4

Clubs, courts and free slots for a day with prices. Public methods.

MethodTitlePathAccess
GETList clubs/v1/clubsPublic
GETClub/v1/clubs/{club_id}Public
GETClub courts/v1/clubs/{club_id}/courtsPublic
GETClub slots for a day/v1/clubs/{club_id}/slotsPublic

Bookings 16

Court booking on behalf of a player: create, reschedule, cancel, waitlist, split payment, rentals, promo codes. Access: a player token.

MethodTitlePathAccess
POSTCreate a booking/v1/bookingsPlayer token
GETMy bookings/v1/bookings/myPlayer token
POSTCancel a booking/v1/bookings/{booking_id}/cancelPlayer token
POSTReschedule a booking/v1/bookings/{booking_id}/reschedulePlayer token
GETMy booking rules in a club/v1/bookings/rulesPlayer token
GETCheck a promo code/v1/promo/checkPlayer token
POSTJoin the waitlist/v1/bookings/waitlistPlayer token
GETMy waitlist/v1/bookings/waitlist/myPlayer token
POSTLeave the waitlist/v1/bookings/waitlist/{wait_id}/cancelPlayer token
POSTSplit the booking payment/v1/bookings/{booking_id}/splitPlayer token
GETMy pending shares/v1/bookings/splits/myPlayer token
POSTPay my share/v1/bookings/splits/{split_id}/acceptPlayer token
GETRental items in a club/v1/bookings/rentalPlayer token
POSTAdd rental to my booking/v1/bookings/{booking_id}/rentalPlayer token
GETRental on a booking/v1/bookings/{booking_id}/rentalPlayer token
GETRental QR for a booking/v1/bookings/{booking_id}/rental-passPlayer token

Wallet and payments 4

Player balance, top-up through YooKassa and YooKassa notifications.

MethodTitlePathAccess
GETPlayer wallet/v1/walletPlayer token
POSTTop up the wallet/v1/wallet/topupPlayer token
GETTop-up payment status/v1/wallet/payments/{payment_id}Player token
POSTYooKassa notification/v1/wallet/yookassa/webhookYooKassa only

Matches 7

Player matches, match card with highlights, manual score entry and correction, rally marking. Access: a player token.

MethodTitlePathAccess
GETMy matches/v1/matches/myPlayer token
GETMatch card/v1/matches/{match_id}Player token
POSTManual score entry/v1/matches/manualPlayer token
POSTScore correction by a referee/v1/matches/{match_id}/score-correctionClub panel account
POSTMark a rally for highlights/v1/matches/markPlayer token
GETMatch text review/v1/matches/{match_id}/reviewPlayer token
POSTShare link for a clip/v1/matches/{match_id}/clips/{clip_id}/sharePlayer token

Players 2

Player profile and recent partners. Access: a player token.

MethodTitlePathAccess
GETRecent players/v1/players/recentPlayer token
GETPlayer profile/v1/players/{player_id}Player token

AISOLUS rating 4

The 1.0–7.0 scale, player rating and top players.

MethodTitlePathAccess
GETRating scale/v1/rating/scalePublic
GETMy rating/v1/rating/mePlayer token
GETAnother player's rating/v1/rating/user/{uid}Player token
GETTop players by AISOLUS rating/v1/rating/leaderboardPlayer token

Leaderboard 1

Leaderboard by Elo rating. Public method.

MethodTitlePathAccess
GETElo leaderboard/v1/leaderboardPublic