Get player by ID

GET

/api/v1/players/{id}

const url = 'https://internal.myscore.live/api/v1/api/v1/players/plr_federer';
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/players/plr_federer

Returns public player details by ID.

Parameters

Path Parameters

required

string

Example

plr_federer

Player ID

Responses

200

Player found

application/json

object

required

Unique player identifier

string

name

required

Player full name

string

nationality

ISO 3166-1 alpha-2 country code

string

nullable

gender

Player gender

string

nullable

Allowed values: male female

profileImageUrl

required

Profile image URL

string

clubs

required

Active club memberships (leftAt IS NULL). Empty array when none.

Array<object>

object

required

Club ID

string

name

required

Club display name

string

role

required

Member’s role within the club

string

Allowed values: member admin

isPrimary

required

Whether this is the player’s primary (Stammverein) club. At most one active membership per player is primary.

boolean

createdAt

required

Record creation timestamp

string format: date-time

updatedAt

required

Record last update timestamp

string format: date-time

Example

{
  "id": "plr_abc123",
  "name": "Rafael Nadal",
  "nationality": "ES",
  "gender": "male",
  "profileImageUrl": "/api/v1/players/plr_abc123/image",
  "clubs": [
    {
      "id": "clb_abc123",
      "name": "TC Musterstadt Süd",
      "role": "member",
      "isPrimary": true
    }
  ],
  "createdAt": "2024-08-15T10:30:00.000Z",
  "updatedAt": "2024-09-01T14:20:00.000Z"
}

404

Player not found