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
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 |
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
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