Versions Compared

Old Version 6

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

Description

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

from

for all sports

PackageThis resource is included in ALL packages

Cache60 seconds
Autorization requiredYes

Method parameters

NameTypeDescription
There are
not
no method parameters in this resource 

Query parameters

NameTypeDescription
username
tokenxsd:stringREQUIRED.
Assigned to you by the 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

in

for participants

which occured

that occurred or

was

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=softnetsport&sport_id=5Returns the list of participants for soccer in XML formathttps://api.softnetsport.com/v2/participants?username=softnetsport
token={{YOUR_TOKEN}}&sport_id=5Returns
the
a list of participants for soccer in JSON format
https://api.
softnetsport
statscore.com/v2/participants?
username=softnetsport
token={{YOUR_TOKEN}}&sport_id=5&season_id=45Returns team participants
from
fof soccer Premiera Division for the season 2014/2015

Output elements

.participant
idUnique identifier of the
participants
participants > participant
type

Include Page
Participant

type. Possible values:
  • team
  • person
nameParticipant nameshort_nameParticipant short name, max length: 20 charactersacronymMax 3 characters length mini namegender

Participant gender. Possible value:

  • male
  • female
  • mixed (for doubles in tennis f.e)
area

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
area represented by the participant. softnetSPORT API provides the following area: areas.index
area_nameParticipant area namesport_idUnique identifier of sport in which participant occures. softnetSPORT API provides the following sports: sports.index
area_codeMax 3 characters length of the short area namenational

Determines if participant is national team

websiteParticipant official website.utInformation about date and time when record was last updated/created. Format YYYY-MM-DD HH:MM:SS. UTC timezone...details (team)details for type participant: team..details (person)details for type participant: personfoundedDate when team was foundedweightParticipant weightphoneDate when team was foundedheightParticipant heightemailDate when team was foundednicknameParticipant nicknameaddressAddres when team is located position_name Name of participant positionvenue_idUnique identifier of venue in which team is playing home gamesbirthdateParticipant birthdatevenue_nameName of venue in which team is playing home games born_place Participant born place  is_retiredDetermines if participant is retired  
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
playing_
  • coach
  • referee
  • director
old_participant_iddepracated. The attribute will be removed from the next API version  

 

...