Versions Compared

Old Version 2

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=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 for
participants
participants > participant
type

Include Page
Participant

type. Could be:
  • team
  • person
name

node
Participant

nameshort_nameParticipant short name, max length: 20 charactesacronymMax 3 characters length mini namegenderParticipant genderarea_idUnique identifier of participant areaarea_nameParticipant area namesport_idUnique identifier of sport in which participant occuresarea_codeMax 3 characters length area namenationalDetermines if participant is national teamwebsiteParticipant official website.utInformation about date and time when record was last updated. 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 locatedposition_idUnique identifier of positionvenue_idUnique identifier of venue in which team is playing home gamesposition_nameName of participant positionvenue_nameName of venue in which team is playing home gamesbirthdateParticipant birthdate  born_placeParticipant born place  

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 position
birthdateParticipanst birthdate
born_placeParticipants place of birth
is_retired

Determines if

participant is retired  subtype_idUnique identifier of subtype for participant  subtype_nameParticipant subtype name, i.e. coach, playing_coach, refree

 

the participant has retired. Possible values:

  • yes
  • no
subtype

Participant subtype name. Possible values:

  • athlete
  • coach
  • referee
  • director