Resource information
softnetsportXSD | https://api.softnetsport.com/assets/API/docs/xsd/seasons.index.xsd |
---|
Method | GET |
---|
Description | Returns |
---|
the a list of all available seasons played in the competitions |
PackageThis resource is included in the SCOUTSFEED, LIVESCORE and STATISTICS packages | Cache | 60 seconds |
---|
Authorization 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 More information concerning |
oAuth token: oAuth 2.0 authorization authorization in API introduction section |
lang | xsd:string | Determines language for the output data. |
softnetSPORT API provides the following languages The complete list of possible languages can be retrieved using the API resource: 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 | Determines the sport to which the season belongs. |
softnetSPORT API provides the following sports The complete list of possible sports can be retrieved using the API resource: sports.index |
competition_id | xsd:int | Determines the competition to which the season belongs. |
softnetSPORT API provides the following competitions Possibility to input multiple identifiers, separated by comma. The complete list of possible competitions can be retrieved using the API resource: competitions.index
|
participant_id | xsd:int | Determines the participant that is included in the seasons. The complete list of possible participants can be retrieved using the API resource: participants.index |
multi_ids | xsd:string | List of season identifiers separated by a comma (e.g. 123,234,321) for the season details you want to get.(Up to 100 ids) |
year | xsd:string | Determines the season year e.g |
:. - 1970
- 1970/71
- 1971
- 1971/72
- 2000
- 2000/01
- 2014
- 2014/15
|
sort_type | xsd:string | Determines sort order of data. Possible values: - competitions - competitions are sorted by overall_sort
- seasons - seasons are sorted by year
|
sort_order | xsd:string | Additional parameter for sort_type which determines the direction of sort (ascending, descending) By default the value of "desc" is set. Possible values: - asc - sort ascending
- desc - sort descending
|
area_id | xsd:int | Determines the area represented by the participant. |
softnetSPORT API provides the following areas: The complete list of possible areas can be retrieved using the API resource: areas.index |
timestamp | xsd:unix_timestamp | Selection date, format UNIX_TIMESTAMP. Only changes in the seasons that occurred or were updated after this timestamp will be returned. |
Method calling examples
Returns a list of season names in XML format | https://api.softnetsport.softnetsport.com/v2/seasons.xml?token={{YOUR_TOKEN}}softnetsport.xmlsoftnetsport.xmlsoftnetsport.xmlOutput elements
. | .. | 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: - country_league - e.g.: Premier Division
- country_cups - e.g.: FA Cup
- international - e.g.: World Cup
- international_clubs - e.g.: Champions League
- friendly - friendly matches
- individual - for speedway individual competitions such as Speedway GP
- team - for speedway national competitions
- single - for tennis competitions
- double - for tennis competitions
- mixed - for tennis competitions
- undefined - other
|
area_id | Unique identifier for area in which the competitions are played. softnetSPORT API provides the following areas: areas.index |
area_name | Name of the area in which the competitions are played |
area_type | Type of area in which competitions are played. Possible values: |
area_sort | The parameter used to sort competitions a the 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 a competition is played. softnetSPORT API provides the following sports: sports.index |
sport_name | Name of the sport in which a competition is played |
tour_id | Unique identifier for the tour in which a competition is played. softnetSPORT API provides the following tours: tours.index |
tour_name | Name of the tour in which a 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 |
| |
---|
| |
---|
id | Unique identifier for the season |
name | Name of the season e.g: Premiership 2014/15 |
year | Determines the season year e.g: - 1970
- 1970/71
- 1971
- 1971/72
- 2000
- 2000/01
- 2014
- 2014/15
|
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 |
.....stages | |
---|
......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 |
...
Include Page |
---|
| Competition node |
---|
| Competition node |
---|
|
|
|
---|
|
---|
|