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 49 Current »

Resource information

URLhttps://api.statscore.com/v2/participants/{participant_id}
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.statscore.com/v2/participants/136928.xml?token={{YOUR_TOKEN}}Returns detailed data for a single participant: FC Barcelona in XML format
https://api.statscore.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
position_idUnique identifier 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
  • athlete/coach
participants > participant > venues
participants > participant > venues > venue


idUnique identifier for the season.
nameName of the season e.g. Premiership 2014/15
short_nameShort name of the venue
countryCountry in which the venue is place
statusStatus of the venue
urlUrl of the venue's website
cityCity in which the venue is place
latLatitude of the venue
lngLongitude of the venue
openedDate when the venue was opened
photoPhoto of the venue
utInformation about the date and time of when the venue record was last updated.
  • No labels