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