Get player match history

GET

/api/v1/players/{id}/matches

const url = 'https://internal.myscore.live/api/v1/api/v1/players/plr_federer/matches?page=1&perPage=20&sortBy=createdAt&sortOrder=asc&status=scheduled&type=freeplay';
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/matches?page=1&perPage=20&sortBy=createdAt&sortOrder=asc&status=scheduled&type=freeplay'

Returns paginated match history for a player, optionally filtered by status.

Parameters

Path Parameters

required

string

Example

plr_federer

Player ID

Query Parameters

page

number

default: 1 >= 1

Example

Page number (1-based)

perPage

number

default: 20 >= 1 <= 100

Example

Items per page

sortBy

string

Example

createdAt

Field to sort by

sortOrder

string

default: desc

Allowed values: asc desc

Example

desc

Sort order

status

string

Allowed values: scheduled in_progress completed cancelled

Filter by match status

type

string

Allowed values: freeplay tournament team_match

Filter by match type

Responses

200

Paginated player match history

404

Player not found