Resource information
| URL | https://api.softnetsport.com/v2/participants |
|---|---|
| Method | GET |
Description | Returns participants (teams or persons) from all sports |
| Package | This resource is included in the STATISTICS package |
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:
|
| subtype | xsd:string | Participant subtype. Possible values:
|
| 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?username=softnetsport&sport_id=5 | Returns the list of participants for soccer in XML format |
| https://api.softnetsport.com/v2/participants?username=softnetsport&sport_id=5 | Returns the list of participants for soccer in JSON format |
| https://api.softnetsport.com/v2/participants?username=softnetsport&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:
|
| 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:
|
| 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:
|
| 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 |
| ...details | |
| founded | Date when the team was founded |
| phone | Phone number |
| 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:
|
| subtype | Participant subtype name. Possible values:
|