Matches

My matches #

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

The player's last 50 matches in card format, without movement grids. The score is always “mine : opponents”.

Headers

Example request

curl -X GET "https://your-server/api/v1/matches/my" \
  -H "Authorization: Bearer <player token>"

Responses

Example response

{
  "items": [
    {
      "id": "8c0f4a52-2d1e-4b7a-9f63-1a5e7d9b3c20",
      "clubId": "c1",
      "club": "Flame Padel",
      "date": "<weekday> 02.10",
      "time": "18:00",
      "teammates": "<you> + Oleg",
      "opponents": "Anna + Maria",
      "upcoming": false,
      "sets": [{"a": 6, "b": 4}, {"a": 3, "b": 6}, {"a": 7, "b": 5}],
      "won": true,
      "verified": true,
      "ratingDelta": 12,
      "voided": false,
      "voidReason": "",
      "ai": null,
      "moments": [],
      "verticals": [],
      "movement": null
    }
  ]
}

Match card #

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

The full match card: score, AI stats, highlights by moment with angles and vertical copies, movement. Participants only, others get 404. Video links are signed per request and live for minutes; an empty url means the video is still on its way to storage (ready=false).

Path parameters

Headers

Example request

curl -X GET "https://your-server/api/v1/matches/8c0f4a52-2d1e-4b7a-9f63-1a5e7d9b3c20" \
  -H "Authorization: Bearer <player token>"

Responses

Manual score entry #

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

A player enters the match score. The author must be a participant; both teams are required. Such a match weighs half in the rating and is not marked as camera-verified.

Headers

Request body application/json

Example request

curl -X POST "https://your-server/api/v1/matches/manual" \
  -H "Authorization: Bearer <player token>" \
  -H "Content-Type: application/json" \
  -d '{
  "club_id": "c1",
  "day": "2026-10-02",
  "time": "18:00",
  "sets": "6:4,6:3",
  "players": [
    {"user_id": "3d6e9a10-5b2c-4f8e-a1d7-6c4b2e0f9a83", "team": 1},
    {"user_id": "a52e7c14-90bd-4e3f-8c61-7d2f0b9e4a15", "team": 2}
  ]
}'

Responses

Example response

{
  "matchId": "8c0f4a52-2d1e-4b7a-9f63-1a5e7d9b3c20",
  "winnerTeam": 1,
  "ratingDeltas": {
    "3d6e9a10-5b2c-4f8e-a1d7-6c4b2e0f9a83": 6,
    "a52e7c14-90bd-4e3f-8c61-7d2f0b9e4a15": -6
  }
}

Score correction by a referee #

Access: Club panel account Header Authorization: Bearer <token> of an account with the referee, admin or owner role; the match club must be the account's club.

A referee, club admin or network owner corrects the score; a reason is required (the reason field). If the winner changes, Elo is recalculated for this match and the following ones; the 1.0–7.0 rating for this match only. The correction goes to the panel activity log. The match club must be the account's club (except for the network owner).

Path parameters

Headers

Request body application/json

Example request

curl -X POST "https://your-server/api/v1/matches/8c0f4a52-2d1e-4b7a-9f63-1a5e7d9b3c20/score-correction" \
  -H "Authorization: Bearer <staff account token>" \
  -H "Content-Type: application/json" \
  -d '{"sets": "4:6,6:3,5:7"}'

Responses

Example response

{
  "ok": true,
  "winnerTeam": 2,
  "ratingDeltas": {
    "3d6e9a10-5b2c-4f8e-a1d7-6c4b2e0f9a83": -11,
    "a52e7c14-90bd-4e3f-8c61-7d2f0b9e4a15": 11
  }
}

Mark a rally for highlights #

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

A player marks the rally just played for highlights. The court is taken from the player's current booking (±15 minutes); without a booking pass club_id and court. The mark reaches the court server in the response to its health report.

Headers

Request body application/json

Example request

curl -X POST "https://your-server/api/v1/matches/mark" \
  -H "Authorization: Bearer <player token>" \
  -H "Content-Type: application/json" \
  -d '{}'

Responses

Example response

{"ok": true, "id": "0d4e8f21-6a3b-4c7d-9e1f-2a5b8c0d3e47", "court": "Court 4"}

Match text review #

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

AI text review of the game for a participant. status: ready (text is set), no_data (no stats), disabled (review is off), failed (could not be produced).

Path parameters

Headers

Example request

curl -X GET "https://your-server/api/v1/matches/8c0f4a52-2d1e-4b7a-9f63-1a5e7d9b3c20/review" \
  -H "Authorization: Bearer <player token>"

Responses

Example response

{"status": "ready", "text": "<review text>", "cached": true}

Share link for a clip #

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

A match participant gets a public link to the clip page (with a social preview).

Path parameters

Headers

Example request

curl -X POST "https://your-server/api/v1/matches/8c0f4a52-2d1e-4b7a-9f63-1a5e7d9b3c20/clips/f0c3a8e1-4d27-4b96-a5e3-9c18d2b7f604/share" \
  -H "Authorization: Bearer <player token>"

Responses

Example response

{"url": "https://your-server/card/clip/<token>", "title": "<clip title>"}