Versions Compared

Old Version 20

changes.mady.by.user Matthew Francis

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
XSDhttps://api.softnetsport.com/assets/API/docs/xsd/participants.index.xsd
MethodGET

Description

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

from

for all sports

Package

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

Method parameters

NameTypeDescription
There are
not
no method parameters in this resource 

Query parameters

NameTypeDescription
tokenxsd:stringREQUIRED.
More
 More information concerning
oAuth token: oAuth 2.0 authorization
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
?token={{YOUR_TOKEN}}&sport_id=5Returns
the list of participants for soccer in XML formathttps://api.softnetsport.com/v2/participants?token={{YOUR_TOKEN}}&sport_id=5Returns the
a list of participants for soccer in JSON format
https://api.
softnetsport
statscore.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

.
..participant idUnique identifier of the participanttype

Participant type. Possible values:

  • team
  • person
nameParticipant nameshort_nameParticipant short name, max length: 20 charactersacronymMax 3 characters length mini name, f.e: BAR, REAgender

Participant gender. Possible value:

  • male
  • female
  • mixed (for doubles in tennis f.e)
area_idUnique identifier of the area represented by the participant. softnetSPORT API provides the following areas: areas.index
area_nameArea name represented by the participantarea_codeMax 3 characters length of the short area name f.e: GER, POL, FRAsport_idUnique identifier of the sport in which participant occures. softnetSPORT API provides the following sports: sports.indexsport_nameName of the sport in which participant occuresnational

Determines if participant is national team. Possible values:

  • yes
  • no
websiteParticipant official websiteutInformation about date and time when the record was last updated. Format UNIX_TIMESTAMPold_participant_iddeprecated. The attribute will be deprecated in next API versionslugfriendly url for participantlogoAttribute for internal purposes...details 
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
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
weight
Participant
Participants weight
height
Participant
Participants height
nickname
Participant
Participants nickname
position_nameName of the participants position
position_idUnique identifier of the
participant
participants position
birthdate
Participant
Participanst birthdate
born_place
Participant 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