Get tournament by ID with host clubs and staff

GET

/api/v1/tournaments/{id}

const url = 'https://internal.myscore.live/api/v1/api/v1/tournaments/trn_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/tournaments/trn_abc123

Public endpoint. Returns the tournament record plus an embedded host clubs list and staff list with display names.

Parameters

Path Parameters

required

string

Example

trn_abc123

Tournament ID

Responses

200

Tournament details

application/json

object

required

Tournament ID

string

name

required

Tournament name

string

description

Tournament description

string

nullable

status

required

Current tournament status

string

Allowed values: upcoming active completed cancelled

sport

required

Sport type

string

Allowed values: tennis padel

surface

Court surface type

string

nullable

Allowed values: clay hard grass indoor

matchFormat

Default match format

string

nullable

Allowed values: best_of_3_mtb best_of_3 short_sets_to_4 pro_set best_of_3_to_4 best_of_5

startDate

Tournament start date

string format: date

nullable

endDate

Tournament end date

string format: date

nullable

registrationDeadline

Registration deadline

string format: date-time

nullable

createdAt

required

Creation timestamp

string format: date-time

updatedAt

required

Last update timestamp

string format: date-time

hostClubs

Host clubs with details

Array<object>

object

required

Club ID

string

clubId

required

Club ID (same as id)

string

tournamentId

required

Tournament ID

string

name

Club name

string

isPrimary

required

Whether this is the primary host club

boolean

createdAt

required

When the club was added

string format: date-time

staff

Tournament staff with user info

Array<object>

object

required

Staff assignment ID

string

tournamentId

required

Tournament ID

string

userId

required

User ID

string

role

required

Staff role

string

Allowed values: owner tournament_manager supervisor referee

displayName

User display name

string

email

User email

string

Example

{
  "id": "tourn_abc123",
  "name": "Barcelona Open 2024",
  "description": "Annual clay court tournament",
  "status": "upcoming",
  "sport": "tennis",
  "surface": "clay",
  "matchFormat": "best_of_3_mtb",
  "startDate": "2026-06-15",
  "endDate": "2026-06-22",
  "registrationDeadline": "2026-06-10T23:59:59.000Z",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-15T10:30:00.000Z",
  "hostClubs": [
    {
      "id": "WIMBLEDON",
      "clubId": "WIMBLEDON",
      "tournamentId": "tourn_abc123",
      "name": "All England Club",
      "isPrimary": false,
      "createdAt": "2026-03-15T10:00:00.000Z"
    }
  ],
  "staff": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tournamentId": "tourn_abc123",
      "userId": "550e8400-e29b-41d4-a716-446655440000",
      "role": "owner",
      "displayName": "Gabriel Admin",
      "email": "gabriel@example.com"
    }
  ]
}

404

Tournament not found