Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 44 Next »

Resource information

URLhttps://api.softnetsport.com/v2/participants/{participant_id}
XSDhttps://api.softnetsport.com/assets/API/docs/xsd/participants.show.xsd
MethodGET

Description

Returns a single participants information
Cache60 seconds
Authorization requiredYes

Method parameters

NameData typeDescription
participant_idxsd:intREQUIRED. The requested participant identifier

Query parameters

NameData typeDescription
tokenxsd:stringREQUIRED. More information concerning authorization in API introduction section
langxsd:string

Determines language for the output data 


Method calling examples

Link
Description
https://api.softnetsport.com/v2/participants/136928.xml?token={{YOUR_TOKEN}}Returns detailed data for a single participant: FC Barcelona in XML format
https://api.softnetsport.com/v2/participants/136928?token={{YOUR_TOKEN}}Returns detailed data for a single participant: FC Barcelona in JSON format

Output elements

participants
participants > participant

idUnique identifier of the participant
type

Participant type. Possible values:

  • team
  • person
  • double
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
gender

Participants gender. Possible value:

  • male
  • female
  • mixed (e.g for mixed doubles in tennis )
area_idUnique identifier for the area represented by the participant.  
area_nameArea name represented by the participant.
area_codeMax 3 characters in length for the abbreviated area name e.g. GER, POL, FRA.
sport_idUnique identifier for the sport in which the participant is involved.
sport_nameName of the sport in which the participant is involved.
national

Determines if participant is a national team. Possible values:

  • yes
  • no
websiteParticipants official website
utInformation about when the date and time of the record was last updated. Format UNIX_TIMESTAMP
old_participant_iddeprecated. The attribute will be removed in the next API version
slugfriendly url for participant
logoAttribute for internal purpose
virtual

Determines if the participant is real player / team or virtual. Possible values:

  • yes
  • no
shirt_nrInformation about player's season number

participants > participant > details
participants > participant > details > detail
foundedDate when the team was founded
phonePhone number
emailEmail address
addressAddress where the team is located
venue_idUnique identifier for the venue in which the team plays home games
venue_nameName of the venue in which the team plays home games
weightParticipants weight
heightParticipants height
nicknameParticipants nickname
position_nameName of the participants position
birthdateParticipants date of birth
born_placeParticipants place of birth
is_retired

Determines if participant has retired. Possible values:

  • yes
  • no
subtype

Participant subtype name. Possible values:

  • athlete
  • coach
  • referee
  • director
  • No labels