Get draw with full bracket

GET

/api/v1/draws/{id}

const url = 'https://internal.myscore.live/api/v1/api/v1/draws/draw_abc123';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://internal.myscore.live/api/v1/api/v1/draws/draw_abc123

Returns draw details including all bracket entries, matches, and players.

Parameters

Path Parameters

required

string

Example

draw_abc123

Draw ID

Responses

200

Draw details with bracket

application/json

object

required

Draw ID

string

name

required

Draw name

string

tournamentId

required

Tournament ID

string

size

required

Bracket size

number

matchFormat

required

Match format

string

Allowed values: best_of_3_mtb best_of_3 short_sets_to_4 pro_set best_of_3_to_4 best_of_5

tiebreakAt

Game score at which tiebreak triggers

number

nullable

finalSetTiebreak

Whether final set uses tiebreak

boolean

nullable

matchTiebreakTo

Points target for match tiebreak

number

nullable

finalized

required

Whether draw is finalized

boolean

goldenPoint

required

Padel Golden Point rule. Metadata only — not enforced by scoring engine yet.

boolean

gender

Gender restriction

string

nullable

Allowed values: male female

ageCategory

Age category

string

nullable

parentDrawId

Parent draw ID (for qualifier draws)

string

nullable

qualifyingSpots

Qualifying spots that advance to parent draw

number

nullable

createdAt

required

Creation timestamp

string format: date-time

updatedAt

required

Last update timestamp

string format: date-time

entries

Bracket entries with matches and players

Array<object>

object

Example

{
  "id": "draw_abc123",
  "name": "Men's Singles",
  "tournamentId": "tourn_abc123",
  "size": 16,
  "matchFormat": "best_of_3_mtb",
  "tiebreakAt": 6,
  "finalSetTiebreak": true,
  "matchTiebreakTo": null,
  "finalized": false,
  "goldenPoint": false,
  "gender": "male",
  "ageCategory": "Open",
  "parentDrawId": "draw_parent123",
  "qualifyingSpots": 2,
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-01-15T12:00:00Z",
  "entries": [
    {
      "id": "entry_1",
      "round": 1,
      "position": 1,
      "matchId": "mat_1",
      "player": {
        "id": "plr_1",
        "name": "Federer"
      }
    }
  ]
}

404

Draw not found