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) for all sports

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

...

NameTypeDescription
tokenxsd:stringREQUIRED. More information concerning authorization in API introduction section
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 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 participated. e.g. 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 for participants that occurred or were updated after this timestamp will be returned.

...

.participants 
..participant 
idUnique identifier of the participant
type

Participant type. Possible values:

  • team
  • person
nameParticipant name
short_nameAbbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g: BAR, REA
gender

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 participant
area_codeMax 3 characters in length of the short area name e.g: GER, POL, FRA
sport_idUnique identifier for the sport in which the participant take part. softnetSPORT API provides the following sports: sports.index 
sport_nameName of the sport in which participant takes part
national

Determines if participant is a national team. Possible values:

  • yes
  • no
websiteParticipants 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 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 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
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