Versions Compared

Old Version 24

changes.mady.by.user Łukasz Lizurej

Saved on

compared with

New Version Current

changes.mady.by.user Adam Kotwicki

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resource information

URLhttps://api.softnetsportstatscore.com/v2/participantsXSDhttps://api.softnetsport.com/assets/API/docs/xsd/participants.index.xsd
MethodGET

Description

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

Cache60 seconds
Autorization requiredYes

...

NameTypeDescription
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

sport_idxsd:intREQUIRED. Identifier for the sport. Allows you to filter participants for the selected sport. The complete list of possible sports can be retrieved using the API resource: sports.index
season_idxsd:intDetermines the season id, in which participants participated. e.g. to get all participants that played in Premiership in 2014/15. The complete list of possible seasons can be retrieved using the API resource: seasons.index
area_idxsd:intDetermines the area represented by the participant. The complete list of possible areas can be retrieved using the API resource: areas.index
multi_idsxsd:stringList of participant identifiers separated by a comma (e.g. 123,234,321) for the details of the participant you want returned. (Up to 100 ids)
typexsd:string

Participant type. Possible values:

  • team
  • person
subtypexsd:string

Participant subtype. Possible values:

  • athlete
  • coach
  • playing_coach
  • referee
  • director
timestampxsd:unix_timestamp

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

virtualxsd:string

Is participant virtual. Possible values:

  • yes
  • no

Method calling examples

softnetsport.com/v2/participants.xml?token={{YOUR_TOKEN}}&sport_id=5
Link
Description
https://api.Returns a list of participants for soccer in XML formathttps://api.softnetsportstatscore.com/v2/participants?token={{YOUR_TOKEN}}&sport_id=5Returns a list of participants for soccer in JSON format
https://api.softnetsportstatscore.com/v2/participants?token={{YOUR_TOKEN}}&sport_id=5&season_id=45Returns team participants fof soccer Premiera Division for the season 2014/2015

Output elements

.
..participant idUnique identifier of the participanttype

Participant type. Possible values:

  • team
  • person
nameParticipant nameshort_nameAbbreviated name, max length: 20 charactersacronymMax 3 characters in length mini name, e.g: BAR, REAgender

Participant gender. Possible value:

  • male
  • female
  • mixed (e.g for doubles in tennis )
area_idUnique identifier for the area represented by the participant
area_nameArea name represented by the participantarea_codeMax 3 characters in length of the short area name e.g: GER, POL, FRAsport_idUnique identifier for the sport in which the participant take part sport_nameName of the sport in which participant takes partnational

Determines if participant is a national team. Possible values:

  • yes
  • no
websiteParticipants official websiteutInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMPold_participant_iddeprecated. The attribute will be removed in next API versionslugfriendly url for participantlogoAttribute for internal purposes...details 
participants
 
participants > participant

Include Page
Participant node
Participant node

participants > participant > details
participants > participant > details > detail


foundedDate when the team was founded
phonePhone number
emailEmail address
addressAddres where the team is located
venue_idUnique identifier of 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
participants position
position_idUnique identifier 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