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 ALL packages |
Method parameters
| Name | Type | Description |
|---|---|---|
| There are not method parameters in this resource | ||
Query parameters
| Name | Type | Description |
|---|---|---|
| username | xsd:string | REQUIRED. Assigned to you by the softnetSPORT administrator |
| 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
.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 | ||
| gender | Participant gender. Possible value:
| ||
| area_id | Unique identifier of the area represented by the participant. softnetSPORT API provides the following area: areas.index | ||
| area_name | Participant area name | ||
| sport_id | Unique identifier of sport in which participant occures. softnetSPORT API provides the following sports: sports.index | ||
| area_code | Max 3 characters length of the short area name | ||
| national | Determines if participant is national team | ||
| website | Participant official website. | ||
| ut | Information about date and time when record was last updated/created. Format YYYY-MM-DD HH:MM:SS. UTC timezone. | ||
| ..details (team) | details for type participant: team | ..details (person) | details for type participant: person |
| founded | Date when team was founded | weight | Participant weight |
| phone | Date when team was founded | height | Participant height |
| Date when team was founded | nickname | Participant nickname | |
| address | Addres when team is located | position_name | Name of participant position |
| venue_id | Unique identifier of venue in which team is playing home games | birthdate | Participant birthdate |
| venue_name | Name of venue in which team is playing home games | born_place | Participant born place |
| is_retired | Determines if participant is retired | ||
| subtype | Participant subtype name. Possible values:
| ||