Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 42 Next »

Resource information

URLhttps://api.statscore.com/v2/standings/{standing_id}
MethodGET

Description

Returns single standings data
Cache60 seconds
Authorization requiredYes

Method parameters

NameTypeDescription
standing_idxsd:intREQUIRED. The requested standing identifier

Query parameters

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

Determines language for the output data 

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

LinkDescription
https://api.statscore.com/v2/standings/21.xml?token={{YOUR_TOKEN}}Returns the selected standings in XML format
https://api.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 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 of selected object e.g. European Championship (competition_season), Premier League (competition_season), FC Barcelona (team),
Relegation Round (stage), FC Barcelona - Manchester United (event)
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.
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
standings > standing > groups
standings > standing > groups > group

idUnique identifier for the group
nameName of the group
utInformation about the date and time of when the group record was last updated. Format UNIX_TIMESTAMP

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

idUnique identifier of the participant
type

Participant type. Possible values:

  • team
  • person
  • double
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
gender

Participants gender. Possible value:

  • male
  • female
  • mixed (e.g for mixed doubles in tennis )
area_idUnique identifier for the area represented by the participant.  
area_nameArea name represented by the participant.
area_codeMax 3 characters in length for the abbreviated area name e.g. GER, POL, FRA.
sport_idUnique identifier for the sport in which the participant is involved.
sport_nameName of the sport in which the participant is involved.
national

Determines if participant is a national team. Possible values:

  • yes
  • no
websiteParticipants official website
utInformation about when the date and time of the record was last updated. Format UNIX_TIMESTAMP
old_participant_iddeprecated. The attribute will be removed in the next API version
slugfriendly url for participant
logoAttribute for internal purpose
virtual

Determines if the participant is real player / team or virtual. Possible values:

  • yes
  • no
shirt_nrInformation about player's season number

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

idUnique identifier for the column
nameName of the column
short_nameAbbreviated name of the column
codeAttribute for internal purpose

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

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
nameName of the zone
colourThe CSS colour for the zone
  • No labels