participants.index

Resource information

URL	https://api.softnetsport.com/v2/participants
XSD	https://api.softnetsport.com/assets/API/docs/xsd/participants.index.xsd
Method	GET
Description	Returns participants (teams or persons) for all sports
Package	This resource is included in the SCOUTSFEED, LIVESCORE and STATISTICS packages
Cache	60 seconds
Autorization required	Yes

Method parameters

Name	Type	Description
There are no method parameters in this resource

Query parameters

Name	Type	Description
token	xsd:string	REQUIRED. More information concerning oAuth token: oAuth 2.0 authorization
lang	xsd:string	Determines language for the output data. softnetSPORT API provides the following languages: languages.index
page	xsd:int	Determines offset of paginated data. Default value is 1 which means first page
limit	xsd: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_id	xsd:int	REQUIRED. Identifier for the sport. Allows you to filter participants for the selected sport. softnetSPORT API provides the following sports: sports.index
season_id	xsd:int	Determines the season id, in which participants participated. e.g. to get all participants that played in Premiership in 2014/15
area_id	xsd:int	Determines the area represented by the participant. softnetSPORT API provides the following areas: areas.index
type	xsd:string	Participant type. Possible values: team person
subtype	xsd:string	Participant subtype. Possible values: athlete coach playing_coach referee director
timestamp	xsd:unix_timestamp	Selection date, format UNIX_TIMESTAMP. Only changes for participants that occurred or were updated after this timestamp will be returned.

Method calling examples

Link	Description
https://api.softnetsport.com/v2/participants.xml?token={{YOUR_TOKEN}}&sport_id=5	Returns a list of participants for soccer in XML format
https://api.softnetsport.com/v2/participants?token={{YOUR_TOKEN}}&sport_id=5	Returns a list of participants for soccer in JSON format
https://api.softnetsport.com/v2/participants?token={{YOUR_TOKEN}}&sport_id=5&season_id=45	Returns team participants fof soccer Premiera Division for the season 2014/2015

Output elements

.participants
..participant
id	Unique identifier of the participant
type	Participant type. Possible values: team person
name	Participant name
short_name	Abbreviated name, max length: 20 characters
acronym	Max 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_id	Unique identifier for the area represented by the participant. softnetSPORT API provides the following areas: areas.index
area_name	Area name represented by the participant
area_code	Max 3 characters in length of the short area name e.g: GER, POL, FRA
sport_id	Unique identifier for the sport in which the participant take part. softnetSPORT API provides the following sports: sports.index
sport_name	Name of the sport in which participant takes part
national	Determines if participant is a national team. Possible values: yes no
website	Participants official website
ut	Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
old_participant_id	deprecated. The attribute will be removed in next API version
slug	friendly url for participant
logo	Attribute for internal purposes
...details
founded	Date when the team was founded
phone	Phone number
email	Email address
address	Addres where the team is located
venue_id	Unique identifier of the venue in which the team plays home games
venue_name	Name of the venue in which the team plays home games
weight	Participants weight
height	Participants height
nickname	Participants nickname
position_name	Name of the participants position
birthdate	Participanst birthdate
born_place	Participants 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