Resource information
URL | https://api.softnetsport.com/v2/competitions/{competition_id} |
---|---|
XSD | https://api.softnetsport.com/assets/API/docs/xsd/competitions.show.xsd |
Method | GET |
Description | Returns data for a single competition |
Cache | 60 seconds |
Authorization required | Yes |
Method parameters
Name | Data type | Description |
---|---|---|
competition_id | xsd:int | REQUIRED. The requested competition identifier |
Query parameters
Name | Data type | Description |
---|---|---|
token | xsd:string | REQUIRED. More information concerning authorization in API introduction section |
lang | xsd:string | Determines the language for the output data. API provides the following languages: languages.index |
Method calling examples
Link | Description |
---|---|
https://api.softnetsport.com/v2/competitions/1528.xml?token={{YOUR_TOKEN}} | Returns detailed data for a single competition e.g. Premier League in XML format |
https://api.softnetsport.com/v2/competitions/1528?token={{YOUR_TOKEN}} | Returns detailed data for a single competition e.g. Premier League 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. API provides the following areas: areas.index |
area_name | Name of the 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 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. 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. API provides the following tours: tours.index |
tour_name | Name of the tour in which competition is played |
ut | Information about when the date and time of 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 |
..seasons | |
...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 when the date and time of the season record was last updated. Format UNIX_TIMESTAMP |
old_season_id | Deprecated. The attribute will be removed in the next API version |