Versions Compared

Old Version 1

changes.mady.by.user FormerUser1

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.statscore.com/v2/participants
MethodGET

Description

Returns

...

Package

This method is included in STATISTICS package.

...

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

Cache60 seconds
Autorization requiredYes

Method parameters

NameTypeDescription
There are no method parameters in this resource 

Query parameters

NameTypeDescription
username
tokenxsd:stringREQUIRED.
Assigned to you by softnetSPORT administrator
 More information concerning 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
of
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
can
participated.
F
e.
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?username=softnetsportReturns the
?token={{YOUR_TOKEN}}&sport_id=5Returns a list of participants for soccer
names
in
XML
JSON format
https://api.
softnetsport
statscore.com/v2/participants?
username=softnetsportReturns the list of participants for soccer in JSON format Returns team participants from
token={{YOUR_TOKEN}}&sport_id=5&season_id=45Returns team participants fof soccer Premiera Division for the season 2014/2015

Output elements

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 stage namenameName of the stage
.stage_name
 
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 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