Versions Compared

Key

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

Resource information

URLhttps://api.
softnetsport
statscore.com/v2/standings/{standing_id}
XSDhttps://api.softnetsport.com/assets/API/docs/xsd/standings.show.xsd
MethodGET

Description

Returns single standings data

Package

This resource is included in the STATISTICS packages
Cache60 seconds
Authorization requiredYes

Method parameters

NameTypeDescription
standing_idxsd:intREQUIRED. The requested standing identifier

Query parameters

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

Determines language for the output data

. softnetSPORT API provides the following languages: languages.index

 

subparticipant_idxsd:intDetermines unique subparticipant id. Could be neccessary to show e.g. top scorers from a single team
participant_idxsd:stringList of participant identifiers separated by a comma (e.g. 123,234,321) for which you want to get results.

Method calling examples

Returns the selected standings in XML formathttps://api.softnetsport.
LinkDescription
https://api.
softnetsport.com/v2/standings/21.xml?token={{YOUR_TOKEN}}
statscore.com/v2/standings/21?token={{YOUR_TOKEN}}Returns the selected standings in JSON format

Output elements

.
standings
 
standings > standing


idUnique identifier for the standings
nameName of the standings
sport_idUnique identifier for the sport in which the standings
occurre. softnetSPORT API provides the following sports: sports.index
occurres 
sport_nameName of the sport
type_idUnique identifier for the standings type. e.g. Away standings, World Cup standings, Event's final result
type_nameName of standings type. e.g. Standings table, Top scorers, Cards
subtype

Name of subtype of standings. Possible values:

  • standings
  • under_over
  • form
  • overall_stats
object_idUnique identifier for object selected in the object_type
object_type

Type of object (kind of scope) for which data is generated. Possible values:

  • sport (e.g. WTA Ranking)
  • season (standings for England Premiership)
  • stage (standings in second round of competitions)
object_nameName
for
of selected object e.g. European Championship (competition_season), Premier League (competition_season), FC Barcelona (team),
Relegation Round (stage), FC Barcelona - Manchester United (event)
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP..groups ...group idUnique identifier for group. Could be empty value
nameName of the group. Could be empty value
stage_name_idUnique identifier for the stage's name.
item_status

Describes status of the item (record). Possible values:

  • active - the record is active
  • deleted - the record was deleted by the admin. When an event was added by mistake
reset_group_rank

Describes type of rank in groups. Possible values:

  • yes - (default) each possible group in standings has it's own rank and it starts from value 1
  • no - all possible groups share the same rank e.g. rank in group B could start from the value higher than last value in group A.
competition_idUnique identifier for the competition
season_idUnique identifier for the season
stage_idUnique identifier for the stage
utInformation about the date and time of when the
group
record was last updated. Format UNIX_TIMESTAMP
....participants .....participant idUnique identifier for participantnameName of participantarea_idArea identifier for participantarea_nameArea name for participantrankPresent rank, place in standingslast_rankLast rank, place in standingszone_nameStandings zone namesubparticipant_idParticipants team identifier (could be empty)subparticipant_nameParticipants team name (could be empty)subparticipant_slugFriendly url for the subparticipant (could be empty)participant_slugFriendly url for the participant.....columns ......column idIdentifier for the columns/statsnameName of the column (title)short_nameAbbreviated name of the column (title)valueValue of the column for a single participant....corrections .....correction


standings > standing > groups
standings > standing > groups > group

Include Page
Group node
Group node

standings > standing > groups > group > participants
standings > standing > groups > group > participants > participant

Include Page
Participant node
Participant node

standings > standing > groups > group > participants > participant > columns
standings > standing > groups > group > participants > participant > columns > column

Include Page
Column node
Column node

standings > standing > groups > group > corrections
standings > standing > groups > group > corrections > correction 


participant_idIdentifier for the participant
participant_nameName of the participant
valueCorrection value, e
,
.g. "+2"
reason
....zones .....zone 

Determines the reason of corrections. Possible reasons:

  • Association decision
  • Disqualified
  • Financial issues
  • Quit
  • Regulations


standings > standing > groups > group > zones
standings > standing > groups > group > zones > zone


idIdentifier for the zone
nameName of the zone
colourThe CSS colour for the zone