Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides previous and upcoming games between two competitors, including scoring information.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…

⏱️

Update Frequency

60s 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:

Competitor info is available at the top of each file and for each individual match.

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
Path Params
string
required
Defaults to trial

The access level of your API key

string
required
Defaults to en

2 letter code for supported languages

en (English) is the only fully supported language for this API. Click here for a tabular list of available languages per competition.

string
required
Defaults to sr:competitor:22456

ID of a given competitor

string
required
Defaults to sr:competitor:22458

ID of a given competitor

string
required
Defaults to json

Format returned

Response

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json