seasons.index
Resource information
URL | https://api.statscore.com/v2/seasons |
---|---|
Method | GET |
Description | Returns a list of all available seasons played in the competitions |
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 information concerning authorization in API introduction section |
lang | xsd:string | Determines language for the output data. 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. 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. 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.
|
sort_type | xsd:string | Determines sort order of data. Possible values:
|
sort_order | xsd:string | Additional parameter for sort_type which determines the direction of sort (ascending, descending)
|
area_id | xsd:int | Determines the area represented by the participant. 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
Link | Description |
---|---|
https://api.statscore.com/v2/seasons?token={{YOUR_TOKEN}} | Returns a list of season names in JSON format |
https://api.statscore.com/v2/seasons?token={{YOUR_TOKEN}}&competition_id=1507 | Returns the seasons played in the competition - Primera Division |
https://api.statscore.com/v2/seasons?token={{YOUR_TOKEN}}&sport_id=5 | Returns all competition seasons played in soccer |
https://api.statscore.com/v2/seasons?token={{YOUR_TOKEN}}&year=2014/15 | Returns all competition seasons played in the season year 2014/15. |
Output elements
competitions | |||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
competitions > competition | |||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||
competitions > competition > seasons | |||||||||||||||||||||||||||||||||||||||||||||||||
competitions > competition > seasons > season | |||||||||||||||||||||||||||||||||||||||||||||||||
|