Players WyID





GET /v2/players/{wyId}


GET /v2/players/{wyId}

back to index


Table of contents

Overview

Retrieves informations about a given player.

Request URL: https://apirest.wyscout.com/v2/players/{wyId}

Parameters

( * parameters are mandatory)

Name Type Default Description
wyId * integer null Unique ID for the required player
details string null Objects to be detailed (separated by commas). See Notes(1) for available objects
imageDataURL boolean false If true, adds the data URL for the player image to the payload

Output

Property Type Condition Value Description
wyId integer always Dynamic Unique ID for this player
shortName string always Dynamic Short name
firstName string always Dynamic First name
middleName string always Dynamic Middle name
lastName string always Dynamic Last name
height integer always Dynamic Height (in cm)
weight integer always Dynamic Weight (in kg)
birthDate string always Dynamic Date of birth
birthArea object always see Notes(2) Details of birth area
passportArea object always see Notes(2) Details of passport area
role object always see Notes(3) Main role
foot string always see Notes(4) Main foot
currentTeamId integer always Dynamic Unique ID of the club team this player is currently playing for
currentNationalTeamId integer always Dynamic Unique ID of the national team this player is currently playing for
currentTeam object details=currentTeam Dynamic Current team details (see GET teams/{wyId} for more info)
gender string always see Notes(5) Player gender
status string always see Notes(6) Player activity status
imageDataURL string imageDataURL=true Dynamic Data URL for player picture

Notes

1. Available objects for additional details

Object Description
currentTeam Current team details (see GET teams/{wyId} for more info)

2. Details of area object

Property Type Value Description
id integer Dynamic Area number (as per ISO 3166-1 specification)
alpha2code string Dynamic Area two-letters code (as per ISO 3166-1 specification)
alpha3code string Dynamic Area three-letters code (as per ISO 3166-1 specification)
name string Dynamic Area english short name (as per ISO 3166-1 specification)

3. Details of role object

Property Type Value Description
name string see Notes(3.a) below Role name
code2 string see Notes(3.a) below Role two-letters code
code3 string see Notes(3.a) below Role three-letters code
3a Available roles and codes
Name Code2 Code3
Goalkeeper GK GKP
Defender DF DEF
Midfielder MD MID
Forward FW FWD

4. Available foot values

Foot Description
right Uses right foot as main foot
left Uses left foot as main foot
both Uses both left and right foot indifferently

5. Available gender values

Gender
male
female

6. Available player statuses

Status Description
active The player is currently active
retired The player has retired
died The player is dead

back to index