Person

Parameter Name Value Description Required
personId integer Unique identifier for the person readonly
linkDetail url link to the detail record readonly
firstName string The first name of the person required
familyName string The family name of the person required
TVName string The name of the person suitable for TV or other media
scoreboardName string The name of the person suitable for Scoreboard
internationalFirstName string The first name of the person suitable for international use. Latin characters only.
internationalFamilyName string The family name of the person suitable for international use. Latin characters only.
namePronunciation string How to pronounce the players name
dob date Date of birth (YYYY-MM-DD)
gender string Gender
  • MALE
  • FEMALE
  • UNKNOWN
required
nickName string A non-official name of the person  
height double The height of the person, in cms  
weight double The weight of the person, in kgs  
dominantHand string The dominant hand used in a match, left or right
  • RIGHT
  • LEFT
dominantFoot string The dominant foot used in a match, left or right
  • RIGHT
  • LEFT
externalId string A unique ID for this person set by the owner of this league.  
internationalReference string A unique string assigned by the sport's international body for this person.  
nationality string The nationality of the person readonly
nationalityCode string The ISO 3166 two letter nationality code  
nationalityCodeIOC string The IOC three letter nationality code readonly
facebook string The public facebook account for the person  
twitter string The public twitter account for the person  
website url Person's external website url The person's default playing number.  
defaultShirtNumber string The person's default playing number.  
defaultPlayingPosition string The person's default playing position.  
primaryClubId integer The unique identifer of the person's primary club.  
primaryClubName string The name of the person's primary club. readonly
linkDetailPrimaryClub url A link to the club detail record of the person's primary club. readonly
primaryTeamId integer unique team identifer The unique identifer of the person's primary team.  
primaryTeamName string The name of the person's primary team. readonly
linkDetailPrimaryTeam url A link to the team detail record of the person's primary team. readonly
images
photo structure The files sub-structure from the Upload Resource. Only present if this person has a photo that has been uploaded. readonly