seasons.participants-stats.index


Resource information

URLhttps://api.statscore.com/v2/seasons/{season_id}/participants-stats
MethodGET

Description

Returns a list of all available participants (teams or persons) for selected season

Cache60 seconds
Autorization requiredYes

Method parameters


NameTypeDescription
season_idxsd:intREQUIRED. The requested season identifier

Query parameters

Name

Type

Description

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

Determines language for the output data. The complete list of possible languages can be retrieved using the API resource: languages.index

pagexsd:intDetermines offset of paginated data. Default value is 1 which means first page
limitxsd:int

Determines maximum number of returned records on page. Used in paginated data. Default value is 500. 

Possible values: 5, 10, 25, 50, 100, 250, 500

area_idxsd:intDetermines the area represented by the participant. The complete list of possible areas can be retrieved using the API resource: areas.index
typexsd:string

Participant type. Possible values:

  • team
  • person
subtypexsd:string

Participant subtype. Possible values:

  • athlete
  • coach
  • playing_coach
  • referee
  • director
participant_idxsd:intList of participants identifiers separated by a comma (e.g. 123,234,321) for the details of the participant you want to be returned. (Up to 100 ids)
subparticipant_idxsd:stringList of subparticipant identifiers separated by a comma (e.g. 123,234,321) for the details of the subparticipant you want to be returned. (Up to 100 ids)
parent_participant_idxsd:intIdentifier of parent_participant for the details of the subparticipants related to parent_participant
timestampxsd:unix_timestamp

Selection date, format UNIX_TIMESTAMP. Only changes for participants that occurred or were updated after this timestamp will be returned.

Method calling examples

Link

Description

https://api.statscore.com/v2/seasons/29847/participants-stats?TOKEN&type=person
Returns a list of persons for the European Championship in JSON format

Output elements

season-participants
season-participants > season-participant



idUnique identifier of the participant
type

Participant type. Possible values:

  • team
  • person
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
foundedDate when the team was founded
weightParticipants weight
heightParticipants height
nicknameParticipants nickname
position_nameName of the participants position
birthdateParticipanst birthdate
born_placeParticipants place of birth
is_retired

Determines if the participant has retired. Possible values:

  • yes
  • no
subtype

Participant subtype name. Possible values:

  • athlete
  • coach
  • referee
  • director
parent_participant_id

Unique identifier of the participant (team).
Empty value will bee return in case of type "team"