Versions Compared

Key

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

...

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

Description

Returns participants (teams or persons) from for all sports

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

...

NameTypeDescription
There are not no method parameters in this resource 

...

NameTypeDescription
tokenxsd:stringREQUIRED. More information concerning oAuth token: oAuth 2.0 authorization
langxsd:string

Determines language for the output data. softnetSPORT API provides the following languages: 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 of for the sport. Allows you to filter participants for the selected sport. softnetSPORT API provides the following sports: sports.index
season_idxsd:intDetermines the season id, in which participants can participated. Fe.eg. to get all participants that played in Premiership in 2014/15
area_idxsd:intDetermines the area represented by the participant. softnetSPORT API provides the following areas: areas.index
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 in for participants which occured that occurred or was were updated after this timestamp will be returned.

...

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

Output elements

.participants 
..participant 
idUnique identifier of the participant
type

Participant type. Possible values:

  • team
  • person
nameParticipant name
short_nameParticipant short Abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, fe.eg: BAR, REA
gender

Participant gender. Possible value:

  • male
  • female
  • mixed (e.g for doubles in tennis f.e )
area_idUnique identifier of for the area represented by the participant. softnetSPORT API provides the following areas: areas.index
area_nameArea name represented by the participant
area_codeMax 3 characters in length of the short area name fe.eg: GER, POL, FRA
sport_idUnique identifier of for the sport in which the participant occurestake part. softnetSPORT API provides the following sports: sports.index
sport_nameName of the sport in which participant occurestakes part
national

Determines if participant is a national team. Possible values:

  • yes
  • no
websiteParticipant Participants official website
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
old_participant_iddeprecated. The attribute will be deprecated removed in next API version
slugfriendly url for participant
logoAttribute for internal purposes
...details 
foundedDate when the team was founded
phonePhone number
emailEmail address
addressAddres when where the team is located
venue_idUnique identifier of the venue in which the team is playing plays home games
venue_nameName of the venue in which the team is playing plays home games
weightParticipant Participants weight
heightParticipant Participants height
nicknameParticipant Participants nickname
position_nameName of the participant articipants position
birthdateParticipant Participanst birthdate
born_placeParticipant born Participants place of birth
is_retired

Determines if the participant is has retired. Possible values:

  • yes
  • no
subtype

Participant subtype name. Possible values:

  • athlete
  • coach
  • referee
  • director