Resource information
| URL | https://api.softnetsport.com/v2/stages/{stage_id} |
|---|---|
| XSD | https://api.softnetsport.com/assets/API/docs/xsd/stages.show.xsd |
| Method | GET |
Description | Returns the selected stage |
| Package | This resource is included in the SCOUTSFEED, LIVESCORE and STATISTICS packages |
| Cache | 60 seconds |
| Authorization required | Yes |
Method parameters
| Name | Type | Description |
|---|---|---|
| stage_id | xsd:int | REQUIRED. The requested stage identifier |
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 |
Method calling examples
Link | Description |
|---|---|
| https://api.softnetsport.com/v2/stages/35.xml?token={{YOUR_TOKEN}} | Returns the selected stage in XML format |
| https://api.softnetsport.com/v2/stages/35.xml?token={{YOUR_TOKEN}} | Returns the selected stage in JSON format |
Output elements
.competition | |
|---|---|
| id | Unique identifier for the competition |
| name | Name of the the competition e.g.: U19 World Champ |
| short_name | Abbreviated name of the competition e.g.: U19 WCH, Max 20 characters |
| mini_name | Mini name of the competition. Max 3 characters in length e.g.: U19 |
| gender | Competition gender. Possible values:
|
| type | Competitions type. Possible values:
|
| area_id | Unique identifier for the area in which competitions are played. softnetSPORT API provides the following areas: areas.index |
| area_name | Name of area in which competitions are played |
| area_type | Type of area in which competitions are played. Possible values:
|
| area_sort | The parameter used to sort competitions in a country, e.g. Premier League is 1st and the Championship is 2nd in English competitions. Sorting direction is ascending |
| area_code | Max 3 characters in length for area in which competitions are played |
| overall_sort | The parameter used to sort competitions. Sorting direction is ascending |
| sport_id | Unique identifier for the sport in which competition is played. softnetSPORT API provides the following sports: sports.index |
| sport_name | Name of the sport in which competition is played |
| tour_id | Unique identifier for the tour in which competition is played. softnetSPORT API provides the following tours: tours.index |
| tour_name | Name of the tour in which competition is played |
| ut | Information about the date and time of when the competition record was last updated. Format UNIX_TIMESTAMP |
| old_competition_id | deprecated. The attribute will be removed in the next API version |
| slug | friendly url for competition |
..season | |
| id | Unique identifier for the season |
| name | Name of the season e.g: Premiership 2014/15 |
| year | Determines the season year e.g:
|
| ut | Information about the date and time of when the season record was last updated. Format UNIX_TIMESTAMP |
| old_season_id | deprecated. The attribute will be removed in the next API version |
...stage | |
| id | Unique identifier for the stage |
| name | Name of the stage |
| start_date | Date when stage begins. Format YYYY-MM-DD |
| end_date | Date when stage ends. Format YYYY-MM-DD |
| show_standings | Determines if the stage contains standings. Possible values:
|
| groups_nr | The number of groups that are part of the stage |
| sort | The sort order for the stage. Sorting direction is ascending |
| is_current | Possible values:
|
| ut | Information about the date and time of when the stage record was last updated. Format UNIX_TIMESTAMP |
| old_stage_id | deprecated. The attribute will be removed in the next API version |
| ....groups | |
| .....group | |
| id | Unique identifier for the group |
| name | Name of the group |
| ut | Information about the date and time of when the group record was last updated. Format UNIX_TIMESTAMP |
| ....participants | |
| .....participant | |
| id | Unique identifier of the participant |
| type | Participant type. Possible values:
|
| name | Participanst name |
| short_name | Participants abbreviated name, max length: 20 characters |
| acronym | Max 3 characters in length mini name, e.g: BAR, REA |
| gender | Participant gender. Possible value:
|
| 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 abbreviated area name e.g. GER, POL, FRA |
| sport_id | Unique identifier for the sport in which participant takes 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 national team. Possible values:
|
| 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 deprecated in next API version |
| slug | friendly url for participant |
| logo | Attribute for internal purposes |