Daily Summaries

get

https://api.sportradar.com/snooker/{access_level}/v2/{language_code}/schedules/{date}/summaries.{format}

Provides match information for a given day, including scoring and results.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
300s Time To Live / Cache

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`sport_event_context` - `category`	String	Country code for a sport event's category
`id`	`sport_event_context` - `category`	String	Unique category ID for a sport event ex. `sr:category:55` (International)
`name`	`sport_event_context` - `category`	String	Name for a sport event's category ex. `International`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a sport event ex. `sr:sport:19`
`name`	`sport_event_context` - `sport`	String	Name for a sport event's sport ex. `Snooker`

Competition

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition ex. `men`, `women`, `mixed`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:21248` (Northern Ireland Open)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Northern Ireland Open`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition ex. `sr:competition:14460`

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:cup:163447` (World Championship 2024)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `World Championship 2024`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group

Rounds

Attribute	Parent Element	Type	Description
`competition_sport_event_number`	`sport_event_context` - `round`	Integer	Sport event number within a competition. Used for competitions that have fixed match numbers.
`name`	`sport_event_context` - `round`	String	Name of a match's round ex. `round_of_16` or `final`
`number`	`sport_event_context` - `round`	Integer	Number of a match's round

Season

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:430` (World Championship)
`disabled`	`sport_event_context` - `season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`sport_event_context` - `season`	Date	End date of a season ex. `2025-07-13`
`id`	`season`	String	Unique ID for a season ex. `sr:season:104989` (World Championship 2024)
`name`	`sport_event_context` - `season`	String	Name of a season ex. `World Championship 2024`
`start_date`	`sport_event_context` - `season`	Date	Start date of a season ex. `2025-06-23`
`year`	`sport_event_context` - `season`	String	Year of a season ex. `24/25` or `2024`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-07-14`
`order`	`sport_event_context` - `stage`	Integer	Order of a stage within a season
`phase`	`sport_event_context` - `stage`	String	Name of a sport event's stage ex. `playoffs`, `regular season` See the enum_phase entry in our Snooker OpenAPI spec for a complete list of valid `phase` enum values
`start_date`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2024-06-24`
`type`	`sport_event_context` - `stage`	String	Type of a match's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a match's stage ex. `23/24` or `2024`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `JON` (Jones, Jak)
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:130248`
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Jones, Jak`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a match `home`, `away`

Coverage Properties

Attribute	Parent Element	Type	Description
`live`	`sport_event` - `coverage`	String	Signifies a sport event is covered live when `true`

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a match ex. `sr:sport_event:48525429`
`best_of`	`sport_event_context` - `mode`	Integer	Provides the number of frames played for the match ex. `best_of="35"`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:51847153`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`resumed`	`sport_event`	Date	Timestamp of the resumed start of a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a match ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a match is confirmed when `true`

Sport Event Status

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status`	Integer	Total score for the away competitor in a match
`home_score`	`sport_event_status`	Integer	Total score for the home competitor in a match
`match_status`	`sport_event_status`	String	Status within a match (sport event). Provides more detail on the state of a match when live than `status` ex. `not_started`, `interrupted`, `in_progress`, `ended` See our FAQ for a complete list of statuses and their definitions.
`count_abandoned`	`sport_event_status`	Boolean	Signifies a match was abandoned by a scout when `true`
`status`	`sport_event_status`	String	Status of a sport event ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions.
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:120814`

Period Scores

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away competitor period score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home competitor period score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Period number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type ex. `regular_period`, `snooker_session_break`

Match Stats (Competitor)

Attribute	Parent Element	Type	Description
`balls_potted`	`competitor` - `statistics`	Integer	Number of balls potted for a competitor in a match
`black_balls_potted`	`competitor` - `statistics`	Integer	Number of black balls potted for a competitor in a match
`blue_balls_potted`	`competitor` - `statistics`	Integer	Number of blue balls potted for a competitor in a match
`breaks_100_plus`	`competitor` - `statistics`	Integer	Number of 100+ point breaks for a competitor in a match
`breaks_50_plus`	`competitor` - `statistics`	Integer	Number of 50+ point breaks for a competitor in a match
`brown_balls_potted`	`competitor` - `statistics`	Integer	Number of brown balls potted for a competitor in a match
`fouls_conceded`	`competitor` - `statistics`	Integer	Number of fouls conceded for a competitor in a match
`green_balls_potted`	`competitor` - `statistics`	Integer	Number of green balls potted for a competitor in a match
`highest_break`	`competitor` - `statistics`	Integer	Highest break number for a competitor in a match
`pink_balls_potted`	`competitor` - `statistics`	Integer	Number of pink balls potted for a competitor in a match
`points`	`competitor` - `statistics`	Integer	Number of total points for a competitor in a match
`red_balls_potted`	`competitor` - `statistics`	Integer	Number of red balls potted for a competitor in a match
`shots_taken`	`competitor` - `statistics`	Integer	Number of total shots taken for a competitor in a match
`time_on_table_percentage`	`competitor` - `statistics`	Double	Percentage of time on the table for a competitor in a match ex. `0.49958207083899`
`time_on_table_seconds`	`competitor` - `statistics`	Integer	Amount of time on the table in seconds for a competitor in a match
`yellow_balls_potted`	`competitor` - `statistics`	Integer	Number of yellow balls potted for a competitor in a match

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

required

Defaults to en

2-letter code for supported languages

en (English)

English is the only fully supported language for this API. Click here for valid language codes and a tabular list of available languages per competition.

date

date

required

Defaults to 2024-09-29

Date in YYYY-MM-DD format

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Query Params

start

int32

The number of items to skip before starting to collect the result set.
Default: 0

Example: start=200 to receive a 2nd page of results (if necessary)

Note: You may alternatively use offset

limit

int32

The number of items to return.
Maximum: 200
Default value: 200

Example: limit=5

Note: Pagination may be required to pull all data within this feed. By default, the feed will return 200 sport events.

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json