Versions Compared

Old Version 21

changes.mady.by.user Matthew Francis

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.
softnetsport
statscore.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

PackageThis resource is included in the SCOUTSFEED, LIVESCORE and STATISTICS packages
Cache60 seconds
Autorization requiredYes

Method parameters

NameTypeDescription
There are no method parameters in this resource 

Query parameters

NameTypeDescription
tokenxsd:stringREQUIRED.
More
 More information concerning
oAuth token: oAuth 2.0 authorization
authorization in API introduction section
langxsd:string

Determines language for the output data.

softnetSPORT API provides the following languages

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.
softnetSPORT API provides the following sports
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.
softnetSPORT API provides the following areas
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

Link
Description
https://api.
softnetsport
statscore.com/v2/participants
.xml
?token={{YOUR_TOKEN}}&sport_id=5Returns a list of participants for soccer in
XML formathttps://api.softnetsport.com/v2/participants?token={{YOUR_TOKEN}}&sport_id=5Returns a list of participants for soccer in
JSON format
https://api.
softnetsport
statscore.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

.
participants
 ..sport_idUnique identifier for the sport in which the participant take part. softnetSPORT API provides the following sports: sports.indexsport_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 > 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. softnetSPORT API provides the following areas: areas.index
area_nameArea name represented by the participantarea_codeMax 3 characters in length of the short area name e.g: GER, POL, FRA

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 position
position_idUnique identifier of the
participants
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