Versions Compared

Key

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

Resource information

URLhttps://api.statscore.com/v2/sports/{sport_id}
MethodGET

Description

Returns information including statuses, result types, details and statistics available for the requested sport 
Cache60 seconds
Authorization requiredYes

Method parameters

Name
Type
Description
sport_idxsd:intREQUIRED. The requested sport identifier

Query parameters

Name
Type
Description
tokenxsd:stringREQUIRED. More information concerning authorization in API introduction section
langxsd:string

Determines language for the output data 

Method calling examples

Link
Description
https://api.statscore.com/v2/sports/5?token={{YOUR_TOKEN}}Returns detailed data for the selected sport in JSON format

Output elements

sport


idUnique identifier for the sport
nameName of the sport
urlName which is used in url address in  API
active

Sport status which means if the sport is supported or not supported in API. Possible values:

  • yes - sport is supported
  • no - sport will be supported in the near future
has_timer

Defines if sport use timer.
Possible values:

  • yes
  • no
participant_quantity

Show information about events participants quantity in sport. Possible values:

  • 2
  • more
template

Internal attribute.

Possible values:

  • default
  • fixed_incidents
incidents_positions

Defines if sport uses incidents positions.
Possible values:

  • yes
  • no
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP


sport > statuses
sport > statuses > status


idUnique identifier for the status
nameName of the status
short_nameAbbreviated name of the status. Max 10 characters
type

Type of the status. Possible values:

  • live
  • scheduled
  • finished
  • cancelled
  • interrupted
  • deleted
  • other
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP


sport > results
sport > results > result


idUnique identifier for the result
short_nameAbbreviated name of the result.
nameName of the result available in all events for the selected sport
codeAttribute for internal purpose
type

Defines type of the result. Possible values:

  • team,
  • person,
  • team_and_person
data_type

Defines type of field generated on front (internal purpose only)

  • integer
  • decimal
  • binary_text
  • binary
  • text
  • signed_integer


sport > stats
sport > stats > team
sport > stats > team > stat


idUnique identifier for the stat
short_nameAbbreviated name of the statistic.
nameName of the stats available for teams in the selected sport
codeAttribute for internal purpose
data_type

Defines type of field generated on front (internal purpose only)

  • integer
  • decimal
  • binary_text
  • binary
  • text
  • signed_integer


sport > stats > person
sport > stats > person > stat
idUnique identifier for the stat
short_nameAbbreviated name of the statistic.
name

Name of the stats available for individuals in the selected sport

codeAttribute for internal purpose
data_type

Defines type of field generated on front (internal purpose only)

  • integer
  • decimal
  • binary_text
  • binary
  • text
  • signed_integer
sport > details
sport > details > detail


idUnique identifier for the detail
nameName of the detail available in all events for the selected sport
codeAttribute for internal purpose
data_type

Defines type of field generated on front (internal purpose only)

  • integer
  • decimal
  • binary_text
  • binary
  • text
  • signed_integer
is_season_detailFor internal purposes
descriptionDescription note of detail
inputInput name e.g. select/input etc
typeType attribute of input
related_statusesStatuses related to detail
formatInput format e.g. for date: "Y-m-d H:i:s"
nullableDetermines if input can be sended with null value
defaultDetermines default value


sport > details > detail > possible_values
sport > details > detail > possible_values > possible_value


keyLabel of value
valuePossible value


sport > incidents
sport > incidents > incident


idUnique identifier for the incident
nameName of the incident available in all events for the selected sport
important

Determines if the incident is important e.g. goals, cards, substitutions. Possible values:

  • yes
  • no
important_for_trader

Determines if incident is important for traders. Possible values:

  • yes - incident is important for trader
  • no - incident isn't important for trader
sport_idUnique identifier for the sport in which a event is played. The complete list of possible sports can be retrieved using the API resource: sports.index
type

Type of incident. Possible values:

  • team
  • event
groupA group which incident belongs to.
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
codeAttribute for internal purpose
forDetermine what the participant includes incident
  • all
  • own
  • rival
  • none
game_breakAttribute for internal purpose


sport > incidents > incident
sport > incidents > incident > attributes


ididsUnique identifier for the attribute
nameName of the attribute
short_nameShort name of the attribute
sort_order


sport > standings_types
sport > standings_types > standings_type


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


sport > standings_types > standings_type > columns
sport > standings_types > standings_type > columns > column


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


sport > standings_types >  > venues_details
sport > standings_types >  > venues_details > detail


idUnique identifier for the venue detail
nameName of the venue detail
descriptionDescription of the venue detail


sport > formations

List of formations used in the events (available only for the Soccer)