Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resource information

URLhttps://api.
softnetsport
statscore.com/v2/competitions/{competition_id}
XSD
https://api.softnetsport.com/assets/API/docs/xsd/competitions.show.xsd
MethodGET

Description

Returns data for a single
competitions data
PackageThis resource is included in the SCOUTSFEED, LIVESCORE and STATISTICS packages
competition
Cache60 seconds
Authorization requiredYes

Method parameters

NameData typeDescription
competition_idxsd:intREQUIRED. The requested competition identifier

Query parameters

NameData typeDescription
tokenxsd:stringREQUIRED.
More
 More information concerning
oAuth token: oAuth 2.0 authorization
authorization in API introduction section
langxsd:string

Determines the 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

...


Method calling examples

Link
Description
https://api.
softnetsport
statscore.com/v2/competitions/1528
.xml?token={{YOUR_TOKEN}}Returns detailed data for a single competition e.g. Premier League in XML formathttps://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
 idUnique identifier for the
competitions
competitions > competition
nameName of the the competition e.g. U19 World Champshort_nameAbbreviated name of the competition e.g. U19 WCH, Max 20 charactersmini_name

Mini name of the competition. Max 3 characters in length e.g. U19

gender

Competition gender. Possible values:

  • male
  • female
  • mixed
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_idUnique identifier for the area in which competitions are played. softnetSPORT API provides the following areas: areas.indexarea_nameName of the area in which competitions are playedarea_type

 Type of area in which competitions are played. Possible values:

  • country
  • international
area_sortThe 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 ascendingarea_codeMax 3 characters for area in which competitions are playedoverall_sortThe parameter used to sort competitions. Sorting direction is ascending
sport_idUnique identifier for the sport in which competition is played. softnetSPORT API provides the following sports: sports.indexsport_nameName of the sport in which competition is playedtour_idUnique identifier for the tour in which competition is played. softnetSPORT API provides the following tours: tours.indextour_nameName of the tour in which competition is playedutInformation about when the date and time of the competition record was last updated. Format UNIX_TIMESTAMPold_competition_iddeprecated. The attribute will be removed in the next API versionslugfriendly url for competition
..seasons
 
...season
 idUnique identifier for the seasonnameName of the season e.g. Premiership 2014/15year

Determines the season year e.g.

  • 1970
  • 1970/71
  • 1971
  • 1971/72
  • 2000
  • 2000/01
  • 2014
  • 2014/15
utInformation about when the date and time of the season record was last updated. Format UNIX_TIMESTAMPold_season_iddeprecated. The attribute will be removed in the next API version

Include Page
Competition node
Competition node

competitions > competition > seasons
competitions > competition > seasons > season

Include Page
Season node
Season node