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) from 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 not 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 of the sport. Allows 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 can participated. F.e. to get all participants played in Premiership 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 in participants which occured or was 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 the list of participants for soccer in XML format
https://api.softnetsport.com/v2/participants?token={{YOUR_TOKEN}}&sport_id=5	Returns the 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 from soccer Premiera Division for 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	Participant short name, max length: 20 characters
acronym	Max 3 characters length mini name, f.e: BAR, REA
gender	Participant gender. Possible value: male female mixed (for doubles in tennis f.e)
area_id	Unique identifier of 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 length of the short area name f.e: GER, POL, FRA
sport_id	Unique identifier of the sport in which participant occures. softnetSPORT API provides the following sports: sports.index
sport_name	Name of the sport in which participant occures
national	Determines if participant is national team. Possible values: yes no
website	Participant official website
ut	Information about date and time when the record was last updated. Format UNIX_TIMESTAMP
old_participant_id	deprecated. The attribute will be deprecated 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 when the team is located
venue_id	Unique identifier of the venue in which team is playing home games
venue_name	Name of the venue in which team is playing home games
weight	Participant weight
height	Participant height
nickname	Participant nickname
position_name	Name of the participant position
birthdate	Participant birthdate
born_place	Participant born place
is_retired	Determines if participant is retired. Possible values: yes no
subtype	Participant subtype name. Possible values: athlete coach referee director