Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides information for all currently live matches, including scoring.

⏱️

Update Frequency

1s Time To Live / Cache



Data Points

Category & Sport:
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category
idsport_event_context - categoryStringUnique category ID for a sport event
ex. sr:category:55 (International)
namesport_event_context - categoryStringName for a sport event's category
ex. International
idsport_event_context - sportStringUnique sport ID for a sport event
ex. sr:sport:19
namesport_event_context - sportStringName for a sport event's sport
ex. Snooker
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
ex. men, women, mixed
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:21248 (Northern Ireland Open)
namesport_event_context - competitionStringName of a competition
ex. Northern Ireland Open
parent_idsport_event_context - competitionStringUnique parent ID for a competition
ex. sr:competition:14460
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:cup:163447 (World Championship 2024)
namesport_event_context - groups - groupStringName of a sport event's group
ex. World Championship 2024
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
Rounds:
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers.
namesport_event_context - roundStringName of a match's round
ex. round_of_16 or final
numbersport_event_context - roundIntegerNumber of a match's round
Season:
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a season belongs to
ex. sr:competition:430 (World Championship)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a season
ex. 2025-07-13
idseasonStringUnique ID for a season
ex. sr:season:104989 (World Championship 2024)
namesport_event_context - seasonStringName of a season
ex. World Championship 2024
start_datesport_event_context - seasonDateStart date of a season
ex. 2025-06-23
yearsport_event_context - seasonStringYear of a season
ex. 24/25 or 2024
Stages:
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage
ex. 2024-07-14
ordersport_event_context - stageIntegerOrder of a stage within a season
phaseName 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_datesport_event_context - stageDateStart date of a sport event's stage
ex. 2024-06-24
typesport_event_context - stageStringType of a match's stage
cup, league
yearsport_event_context - stageStringYear of a match's stage
ex. 23/24 or 2024
Competitor:
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. JON (Jones, Jak)
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:130248
namecompetitors - competitorStringName for a competitor
ex. Jones, Jak
qualifiercompetitors - competitorStringDesignation of a competitor for a match
home, away
Coverage Properties:
AttributeParent ElementTypeDescription
livesport_event - coverageStringSignifies a sport event is covered live when true
Sport Event:
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a match
ex. sr:sport_event:48525429
best_ofsport_event_context - modeIntegerProvides the number of frames played for the match
ex. best_of="35"
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:51847153
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match
ex. 2024-03-26T20:00:00+00:00
resumedsport_eventDateTimestamp of the resumed start of a match
ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a match
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a match is confirmed when true
Sport Event Status:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away competitor in a match
home_scoresport_event_statusIntegerTotal score for the home competitor in a match
match_statussport_event_statusStringStatus 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.
scount_abandonedsport_event_statusBooleanSignifies a match was abandoned by a scout when true
statussport_event_statusStringStatus of a sport event
ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the match winner
ex. sr:competitor:120814
Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway competitor period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome competitor period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type
ex. regular_period, snooker_session_break
Match Stats (Competitor):
AttributeParent ElementTypeDescription
balls_pottedcompetitor - statisticsIntegerNumber of balls potted for a competitor in a match
black_balls_pottedcompetitor - statisticsIntegerNumber of black balls potted for a competitor in a match
blue_balls_pottedcompetitor - statisticsIntegerNumber of blue balls potted for a competitor in a match
breaks_100_pluscompetitor - statisticsIntegerNumber of 100+ point breaks for a competitor in a match
breaks_50_pluscompetitor - statisticsIntegerNumber of 50+ point breaks for a competitor in a match
brown_balls_pottedcompetitor - statisticsIntegerNumber of brown balls potted for a competitor in a match
fouls_concededcompetitor - statisticsIntegerNumber of fouls conceded for a competitor in a match
green_balls_pottedcompetitor - statisticsIntegerNumber of green balls potted for a competitor in a match
highest_breakcompetitor - statisticsIntegerHighest break number for a competitor in a match
pink_balls_pottedcompetitor - statisticsIntegerNumber of pink balls potted for a competitor in a match
pointscompetitor - statisticsIntegerNumber of total points for a competitor in a match
red_balls_pottedcompetitor - statisticsIntegerNumber of red balls potted for a competitor in a match
shots_takencompetitor - statisticsIntegerNumber of total shots taken for a competitor in a match
time_on_table_percentagecompetitor - statisticsDoublePercentage of time on the table for a competitor in a match
ex. 0.49958207083899
time_on_table_secondscompetitor - statisticsIntegerAmount of time on the table in seconds for a competitor in a match
yellow_balls_pottedcompetitor - statisticsIntegerNumber of yellow balls potted for a competitor in a match
Language
Credentials
Query
Click Try It! to start a request and see the response here!