Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Match Summary

Provides real-time match-level statistics for a given match. Including results and player and team stats. Please note that data returned is determined by coverage level.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

1s Time To Live / Cache


Data Points

Category & Sport
AttributeParent ElementTypeDescription
country_codesport_event - tournament - categoryStringCountry code for a tournament's category
idsport_event - tournament - categoryStringUnique category ID for a tournament

ex. sr:category:105
namesport_event - tournament - categoryStringName for a tournament's category

ex. International
idsport_event - tournament - sportStringUnique sport ID for a tournament

ex. sr:sport:21
namesport_event - tournament - sportStringName for a tournament's sport

ex. Cricket
Season
AttributeParent ElementTypeDescription
end_datesport_event - seasonDateEnd date of a sport event's season

ex. 2024-06-17
idsport_event - seasonStringUnique ID for a sport event's season

ex. sr:season:122977 (Sheffield Shield 24/25)
namesport_event - seasonStringName of a sport event's season

ex. Sheffield Shield 24/25
start_datesport_event - seasonDateStart date of a sport event's season

ex. 2023-09-23
tournament_idsport_event - seasonStringUnique tournament ID for a sport event's season

ex. sr:tournament:21568 (Sheffield Shield)
yearsport_event - seasonStringYear of a sport event's season

ex. 23/24 or 2024
Tournament
AttributeParent ElementTypeDescription
gendersport_event - tournamentStringGender of a sport event's tournament

men, women, mixed
idsport_event - tournamentStringUnique ID for a sport event's tournament

ex. sr:tournament:21568 (Sheffield Shield)
namesport_event - tournamentStringName of a sport event's tournament

ex. Sheffield Shield
typesport_event - tournamentStringType of a sport event's tournament

test, odi, t10, t20i, first_class, list_a, t20, the_hundred
namesport_event - tournament_roundStringName of a sport event's tournament round
numbersport_event - tournament_roundIntegerNumber of a sport event's tournament round
typesport_event - tournament_roundStringType of a sport event's tournament round

ex. group
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitors - teamStringAbbreviation for a competitor name

ex. BUL (Queensland Bulls)
countrycompetitors - teamStringCountry of a competitor

ex. Australia
country_codecompetitors - teamStringCountry code of a competitor

ex. AUS (Australia)
gendercompetitors - teamStringGender for a competitor

male, female
idcompetitors - teamStringUnique ID for a competitor

ex. sr:competitor:142678 (Queensland Bulls)
namecompetitors - teamStringName for a competitor

ex. Queensland Bulls
qualifiercompetitors - teamStringDesignation of a competitor for a sport event

home, away
virtualcompetitors - teamBooleanSignifies a competitor is a virtual team when true. Used for placeholder teams in TBD vs TBD matchups.
Player
AttributeParent ElementTypeDescription
idplayerStringUnique ID of a player

ex. sr:player:696896
nameplayerStringName of a player

ex. Sarkar, Soumya
Sport Event
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a sport event

ex. sr:sport_event:52962997
scheduledsport_eventDate-timeScheduled start time of a match

ex. 2025-02-08T00:00:00+00:00
start_time_tbdsport_eventBooleanSignifies the start time of a match is TBD when true
statussport_eventStringStatus of a match.

See our FAQ for a complete list of statuses and their definitions
Sport Event Conditions
AttributeParent ElementTypeDescription
day_nightsport_event_conditionsStringSignifies a day or night match

day, night
neutral_venuesport_event_conditionsBooleanSignifies a match is played at a neutral site when true
typesport_event_conditionsStringType of a match

test, odi, t10, t20i, first_class, list_a, t20
rain_conditionssport_event_conditions - weather_infoStringRain conditions for a match

no_rain, expected_soon, showers, rain, heavy_rain, unknown
sky_conditionssport_event_conditions - weather_infoStringSky conditions for a match

clear, partly_cloudy, cloudy, overcast, unknown
temperature_rangesport_event_conditions - weather_infoStringTemperature range for a match

very_hot, hot, warm, mild, cold, very_cold, unknown
wind_conditionssport_event_conditions - weather_infoStringWind conditions for a match

no_wind, breeze, windy, gale, unknown
boundary_positionsport_event_conditions - pitch_infoStringBoundary position of the pitch for a match

in, normal, unknown
grass_coversport_event_conditions - pitch_infoStringGrass cover of the pitch for a match

barren, normal, green, unknown
pitch_moisturesport_event_conditions - pitch_infoStringMoisture of the pitch for a match

very_dry, dry, normal, moist, unknown
pitch_qualitysport_event_conditions - pitch_infoStringQuality of the pitch for a match

normal, delayed, deteriorating, slow, low, unknown
outfield_conditionssport_event_conditions - outfield_infoStringOutfield conditions for a match

slow, normal, fast
Sport Event - Coverage Properties
AttributeParent ElementTypeDescription
typecoverageStringType of coverage

sport_event
levelcoverage - sport_event_propertyStringCoverage level for a match. See our FAQ for detailed descriptions of each level

post, core, advanced, fielding
Period Scores
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway team inning score
allotted_overssport_event_status - period_scores - period_scoreIntegerNumber of allotted overs for an inning
away_wicketssport_event_status - period_scores - period_scoreIntegerNumber of away wickets in an inning
display_overssport_event_status - period_scores - period_scoreFloatNumber of overs for an inning

ex. 33.3
display_scoresport_event_status - period_scores - period_scoreStringDisplay score for an inning

ex. 144/10
home_scoresport_event_status - period_scores - period_scoreIntegerHome team inning score
home_wicketssport_event_status - period_scores - period_scoreIntegerNumber of home wickets in an inning
numbersport_event_status - period_scores - period_scoreIntegerInning number
typesport_event_status - period_scores - period_scoreStringPeriod type

ex. inning
Sport Event Status
AttributeParent ElementTypeDescription
allotted_overssport_event_statusIntegerNumber of allotted overs for the current inning
current_inningsport_event_statusIntegerCurrent inning of a match
current_sessionsport_event_statusIntegerCurrent session of a match
display_overssport_event_statusFloatNumber of overs for the current inning

ex. 33.3
display_scoresport_event_statusStringDisplay score for the current inning

ex. 144/10
match_result_textsport_event_statusStringText description of the result of a match

ex. Oval Invincibles won by 6 wickets or London Spirit won by 17 runs
match_statussport_event_statusStringStatus within a match (sport event). Provides more detail on the state of a match when live than status

ex. first_innings_away, stumps, ended, tea_break

See our FAQ for a complete list of statuses
required_run_ratesport_event_statusFloatThe run rate the batting side must achieve in order to win a match

ex. 20.222
run_ratesport_event_statusFloatCurrent run rate of the batting side

ex. 4.3
statussport_event_statusStringStatus of a match

ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions
toss_decisionsport_event_statusStringDecision of the team winning the toss

ex. bat, bowl
toss_won_bysport_event_statusStringUnique ID of the team which won the toss

ex. sr:competitor:142710
winner_idsport_event_statusStringUnique ID of the match winner

ex. sr:competitor:142704
Match Stats - Inning
AttributeParent ElementTypeDescription
batting_teamstatistics - inningStringUnique ID of the batting team in an inning

ex. sr:competitor:142710
bowling_teamstatistics - inningStringUnique ID of the bowling team in an inning

ex. sr:competitor:107203
numberstatistics - inningIntegerNumber of an inning
overs_completedstatistics - inningIntegerNumber of overs completed in an inning
Match Stats - Batting (Team)
AttributeParent ElementTypeDescription
balls_remaininginning - team - statistics - battingIntegerNumber of balls remaining in an inning for a batting team
foursinning - team - statistics - battingIntegerNumber of fours in an inning for a batting team
overs_remaininginning - team - statistics - battingIntegerNumber of overs remaining in an inning for a batting team
penalty_runsinning - team - statistics - battingIntegerNumber of penalty runs in an inning for a batting team
reviews_remaininginning - team - statistics - battingIntegerNumber of reviews remaining in an inning for a batting team
run_rateinning - team - statistics - battingFloatRun rate of the batting team in an inning

ex. 4.3
runsinning - team - statistics - battingIntegerNumber of runs in an inning for a batting team
sixesinning - team - statistics - battingIntegerNumber of sixes in an inning for a batting team
wickets_lostinning - team - statistics - battingIntegerNumber of wickets lost in an inning for a batting team
Match Stats - Bowling (Team)
AttributeParent ElementTypeDescription
byesinning - team - statistics - bowlingIntegerNumber of byes in an inning for a bowling team
dot_ballsinning - team - statistics - bowlingIntegerNumber of dot balls in an inning for a bowling team
bowling_extrasinning - team - statistics - bowlingIntegerNumber of extras in an inning for a bowling team
leg_byesinning - team - statistics - bowlingIntegerNumber of leg byes in an inning for a bowling team
maidensinning - team - statistics - bowlingIntegerNumber of maidens in an inning for a bowling team
oversinning - team - statistics - bowlingIntegerNumber of overs in an inning for a bowling team
bowling_reviews_remaininginning - team - statistics - bowlingIntegerNumber of reviews remaining in an inning for a bowling team
wicketsinning - team - statistics - bowlingIntegerNumber of wickets in an inning for a bowling team
widesinning - team - statistics - bowlingIntegerNumber of wides in an inning for a bowling team
Match Stats - Bowling Spell
AttributeParent ElementTypeDescription
spell_orderinning - team - statistics - bowling - bowling_spellIntegerSpell order for a bowling team
startinning - team - statistics - bowling - bowling_spellFloatDisplay score at the beginning of a bowling spell
start_timeinning - team - statistics - bowling - bowling_spellDate-timeTimestamp of the start of a bowling spell

ex. 2024-08-04T14:11:19.994Z
endinning - team - statistics - bowling - bowling_spellFloatDisplay score of a bowling spell
end_timeinning - team - statistics - bowling - bowling_spellDate-timeTimestamp of the end of a bowling spell

ex. 2024-08-04T14:11:19.994Z
conceded_runsinning - team - statistics - bowling - bowling_spellIntegerNumber of conceded runs for a bowling spell
dot_ballsinning - team - statistics - bowling - bowling_spellIntegerNumber of dot balls for a bowling spell
economy_rateinning - team - statistics - bowling - bowling_spellFloatEconomy rate for a bowling spell

ex. 3.3
maidensinning - team - statistics - bowling - bowling_spellIntegerNumber of maidens for a bowling spell
no_ballsinning - team - statistics - bowling - bowling_spellIntegerNumber of no-balls for a bowling spell
overs_bowledinning - team - statistics - bowling - bowling_spellIntegerNumber of overs bowled for a bowling spell
wicketsinning - team - statistics - bowling - bowling_spellIntegerNumber of wickets for a bowling spell
widesinning - team - statistics - bowling - bowling_spellIntegerNumber of wides for a bowling spell
nameinning - team - statistics - bowling - bowling_spell - playerStringBowler name for a bowling spell
idinning - team - statistics - bowling - bowling_spell - playerStringUnique ID for the bowler of a bowling spell

ex. sr:player:1984093
Match Stats - Batting Partnerships
AttributeParent ElementTypeDescription
balls_facedinning - team - statistics - batting - partnershipIntegerNumber of balls faced for a batting partnership in an inning
dismissed_playerinning - team - statistics - batting - partnershipStringUnique ID of a dismissed player from a batting partnership in an inning
endinning - team - statistics - batting - partnershipFloatDisplay score for a batting partnership
end_timeinning - team - statistics - batting - partnershipDate-timeTimestamp of the end of a partnership end

ex. 2024-08-04T14:11:19.994Z
oversinning - team - statistics - batting - partnershipIntegerNumber of overs for a batting partnership in an inning
runsinning - team - statistics - batting - partnershipIntegerNumber of runs scored for a batting partnership in an inning
runs_extrasinning - team - statistics - batting - partnershipIntegerNumber of runs scored from extras for a batting partnership in an inning
startinning - team - statistics - batting - partnershipFloatDisplay score at the beginning of a batting partnership
start_timeinning - team - statistics - batting - partnershipDate-timeTimestamp of the start of a partnership end

ex. 2024-08-04T14:11:19.994Z
wicket_numberinning - team - statistics - batting - partnershipIntegerWicket number for a batting partnership in an inning
Match Stats - Batting Partnerships (Player)
AttributeParent ElementTypeDescription
balls_facedinning - team - statistics - batting - partnership - playerIntegerNumber of balls faced for a batting partner in a partnership
dot_ballsinning - team - statistics - batting - partnership - playerIntegerNumber of dot balls for a batting partner in a partnership
foursinning - team - statistics - batting - partnership - playerIntegerNumber of fours for a batting partner in a partnership
onesinning - team - statistics - batting - partnership - playerIntegerNumber of ones for a batting partner in a partnership
orderinning - team - statistics - batting - partnership - playerIntegerOrder number for a batting partner in an inning
runsinning - team - statistics - batting - partnership - playerIntegerNumber of total runs for a batting partner in a partnership
sixesinning - team - statistics - batting - partnership - playerIntegerNumber of sixes for a batting partner in a partnership
statusinning - team - statistics - batting - partnership - playerStringStatus of a batting partner in a partnership

OUT, NOT_OUT, RETIRED
strike_rateinning - team - statistics - batting - partnership - playerFloatStrike rate for a batting partner in a partnership
threesinning - team - statistics - batting - partnership - playerIntegerNumber of threes for a batting partner in a partnership
twosinning - team - statistics - batting - partnership - playerIntegerNumber of twos for a batting partner in a partnership
Match Stats - Batting (Player)
AttributeParent ElementTypeDescription
balls_facedteam - batting - player - statisticsIntegerNumber of balls faced by a batter in an inning
dot_ballsteam - batting - player - statisticsIntegerNumber of dot balls by a batter in an inning
foursteam - batting - player - statisticsIntegerNumber of fours by a batter in an inning
minutes_at_creaseteam - batting - player - statisticsIntegerNumber of minutes at the crease by a batter in an inning
onesteam - batting - player - statisticsIntegerNumber of ones by a batter in an inning
orderteam - batting - player - statisticsIntegerOrder number for a batter in an inning
runsteam - batting - player - statisticsIntegerNumber of runs scored by a batter in an inning
shots_attackingteam - batting - player - statisticsIntegerNumber of attacking shots by a batter in an inning
sixesteam - batting - player - statisticsIntegerNumber of sixes by a batter in an inning
strike_rateteam - batting - player - statisticsFloatStrike rate for a batter in an inning

ex. 73.68
threesteam - batting - player - statisticsIntegerNumber of threes by a batter in an inning
twosteam - batting - player - statisticsIntegerNumber of twos by a batter in an inning
ball_numberteam - batting - player - statistics - dismissalIntegerBall number for a batter's dismissal
bowler_idteam - batting - player - statistics - dismissalStringUnique player ID for the bowler on pitch for a batter's dismissal
over_numberteam - batting - player - statistics - dismissalIntegerOver number for a batter's dismissal
typeteam - batting - player - statistics - dismissalStringType of a batter's dismissal

unknown, caught, leg_before_wicket, bowled, stumped, run_out, hit_wicket, retired_hurt, hit_twice, timed_out, handled_ball, obstructing_field, retired, retired_not_out, absent
Match Stats - Bowling (Player)
AttributeParent ElementTypeDescription
appealsteam - bowling - player - statisticsIntegerNumber of appeals for a bowler in an inning
around_the_wicketteam - bowling - player - statisticsIntegerNumber of around the wickets for a bowler in an inning
conceded_runsteam - bowling - player - statisticsIntegerNumber of runs conceded for a bowler in an inning
dot_ballsteam - bowling - player - statisticsIntegerNumber of dot balls for a bowler in an inning
economy_rateteam - bowling - player - statisticsFloatEconomy rate for a bowler in an inning
edgesteam - bowling - player - statisticsIntegerNumber of edges for a bowler in an inning
maidensteam - bowling - player - statisticsIntegerNumber of maidens for a bowler in an inning
no_ballsteam - bowling - player - statisticsIntegerNumber of no-balls for a bowler in an inning
orderteam - bowling - player - statisticsIntegerOrder number for a bowler in an inning
over_the_wicketteam - bowling - player - statisticsIntegerNumber of over the wickets for a bowler in an inning
overs_bowledteam - bowling - player - statisticsIntegerNumber of overs bowled for a bowler in an inning
wicketsteam - bowling - player - statisticsIntegerNumber of wickets for a bowler in an inning
widesteam - bowling - player - statisticsIntegerNumber of wides for a bowler in an inning
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue

ex. 22500
city_idvenueStringUnique ID of a city

ex. sr:city:59
city_namevenueStringCity name of a venue

ex. Sylhet
country_codevenueStringCountry code of a venue

ex. BGD (Bangladesh)
country_namevenueStringCountry name of a venue

ex. Bangladesh
idvenueStringUnique ID of a venue

ex. sr:venue:24744
map_coordinatesvenueStringCoordinates of a venue

ex. 24.920781,91.868653
namevenueStringName of a venue

ex. Sylhet International Cricket Stadium
timezonevenueStringTimezone of a venue

ex. Asia/Kolkata
statevenueStringState of a venue

ex. Sylhet International Cricket Stadium
namevenue - bowling_endStringName of a venue bowling end

ex. Anna Pavilion End, V Pattabhiraman Gate End
Path Params
string
enum
required
Defaults to t

The access level of your API key

t (trial), p (production)

Allowed:
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.

string
required
Defaults to sr:match:58145219

Unique Id of a match

Example: sr:match:58145219

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

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