Score by Ball
About get_premiumscorecard
The get_ premiumscorecard method is used to get a description of the current state of an In Play match and it provides you with ball-by-ball information. The Sportradar Event ID of the required event is passed as a parameter to the method.
Suggested Usage
This is intended for display purposes only, and should not be relied upon for pricing, bet settlement, or any other management of event state related to betting
Request Example
https://cricketapi.sportradar.com/UnifiedFeedScoring/json/get_premiumscorecard?event_Id=sr:match:42096363Response Structure
<GetScoreResponse xmlns="http://schemas.datacontract.org/2004/07/Sportradar.OddsFeed.PremiumCricket.Scoring.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<action>Success</action>
<message>OK.</message>
<response_code>OK</response_code>
<score i:type="b:PremiumScorecardMatch" xmlns:a="http://schemas.datacontract.org/2004/07/Sportradar.OddsFeed.PremiumCricket.Scoring" xmlns:b="http://schemas.datacontract.org/2004/07/Sportradar.OddsFeed.PremiumCricket.Scoring.Cricket">
<a:bettingSuspended>false</a:bettingSuspended>
<a:eventId>sr:match:42096363</a:eventId>
<a:premiumCricketEventId>42096363</a:premiumCricketEventId>
<a:updateId>6193</a:updateId>
<b:matchId>42096363</b:matchId>
<b:seriesName>0</b:seriesName>
<b:matchTitle>Texas Super Kings v MI New York (20 Overs Each)</b:matchTitle>
<b:matchCommentary>Texas Super Kings have won by 17 runs</b:matchCommentary>
<b:matchStatus>MatchComplete</b:matchStatus> <b:currentInningsNumber>2</b:currentInningsNumber>
<b:timeStamp>2023-07-18T04:21:24.5631505Z</b:timeStamp>
<b:innings>
<b:ScorecardInnings>
<b:inningsNumber>1</b:inningsNumber>
<b:runs>154</b:runs>
<b:wickets>7</b:wickets>
<b:overs>20</b:overs>
<b:oversAvailable>20</b:oversAvailable>
<b:teamName>Texas Super Kings</b:teamName>
<b:conclusion>Completed</b:conclusion>
<b:summary>154/7</b:summary>
<b:competitorId>sr:competitor:1030331</b:competitorId>
<b:isFollowOn>false</b:isFollowOn>
<b:isFinalInnings>false</b:isFinalInnings>
<b:hasTarget>false</b:hasTarget>
<b:target>0</b:target>
<b:extrasSummary>
<b:byes>0</b:byes>
<b:noBalls>0</b:noBalls>
<b:legByes>4</b:legByes>
<b:wides>2</b:wides>
<b:penalties>0</b:penalties>
</b:extrasSummary>
<b:fallOfwickets>F du Plessis 20/1 (2.5), C Chetty 58/2 (8.3), DA Miller 112/3 (15.3), DP Conway 122/4 (16.5), DJ Bravo 135/5 (17.6), DR Sams 153/6 (19.4), MJ Santner 153/7 (19.5), </b:fallOfwickets>
<b:batsmen>
<b:ScorecardBatsman>
<b:batsmanName>DP Conway</b:batsmanName>
<b:active>false</b:active>
<b:onStrike>false</b:onStrike>
<b:fours>8</b:fours>
<b:sixes>1</b:sixes>
<b:runs>74</b:runs>
<b:balls>55</b:balls>
<b:playerId>sr:player:680246</b:playerId>
<b:description>Bowled</b:description>
<b:toCome>false</b:toCome>
<b:didNotBat>false</b:didNotBat>
<b:fielderId i:nil="true"/>
<b:fielderName/>
<b:bowlerId>sr:player:968267</b:bowlerId>
<b:bowlerName>Rashid Khan</b:bowlerName>
<b:description2> bowled </b:description2>
</b:ScorecardBatsman>
......
</b:batsmen>
<b:bowlers>
<b:ScorecardBowler>
<b:bowlerName>TA Boult</b:bowlerName>
<b:playerId>sr:player:649644</b:playerId>
<b:overs>4</b:overs>
<b:balls>0</b:balls>
<b:maidens>0</b:maidens>
<b:runs>29</b:runs>
<b:wickets>2</b:wickets>
<b:wides>1</b:wides>
<b:noBalls>0</b:noBalls>
<b:isActiveBowler>false</b:isActiveBowler>
<b:fours>3</b:fours>
<b:sixes>1</b:sixes>
<b:dotBalls>12</b:dotBalls>
<b:isOtherBowler>false</b:isOtherBowler>
</b:ScorecardBowler>
......
</b:bowlers>
</b:ScorecardInnings>
</b:innings>
<b:recentOvers>
<b:ScorecardOver>
<b:overNumber>21</b:overNumber>
<b:runs>0</b:runs>
<b:isCurrentOver>true</b:isCurrentOver>
<b:balls xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<c:string/>
<c:string/>
<c:string/>
<c:string/>
......
</b:balls>
</b:ScorecardOver>
</b:recentOvers>
<b:wormAndManhattan>
<b:ScorecardOverSummary>
<b:overNumber>1</b:overNumber>
<b:firstInnings>10,0,10,0</b:firstInnings>
<b:secondInnings>3,0,3,0</b:secondInnings>
<b:thirdInnings/>
<b:fourthInnings/>
</b:ScorecardOverSummary>
......
</b:ballByBallSummaries>
</score>
</GetScoreResponse>Elements and Sub-elements Explained
GetScoreResponse
action
Information indicating details of any errors when making API call.
message
Punctuated HTTP response code.
response_code
HTTP response code.
score
Member of type ScorecardMatch, containing details of match state
ScorecardMatch
bettingSuspended
Boolean, indicates if the match is currently suspended
eventId
The ID of the event, will correspond to the ID passed as a parameter.
premiumCricketEventId
Legacy ID for the match, should be ignored.
matchId
Legacy ID for the match (same as premiumCricketEventId), should be ignored.
updateId
Counter that increments as score updates are made during the match.
seriesName
Redundant legacy field, should be ignored.
matchTitle
A text description of the match Title.
matchCommentary
A text summary of the current match state.
matchStatus
MatchStatusEnum representing the current state of the match.
currentInningsNumber
The number of the current innings.
innings
A list of type ScorecardInnings, containing information about the scores of the Innings.
recentOvers
A list of type ScorecardOver, containing information about the scores of the Innings. Only the last four overs are shown.
timestamp
The time in UTC that the update occurred
wormAndManhattan
The worm and manhattan
ballByBallSummaries
Ball by ball summaries
MatchStatusEnum
PreToss (0)
Awaiting Toss.
PostToss (1)
Toss complete, awaiting start of match.
MatchInProgress(2)
Match is in progress.
Interval (3)
Match has stopped for an interval (Lunch, Tea, Overnight).
MatchComplete (4)
Match is complete.
ScorecardInnings
inningsNumber
The number of the innings in the match.
runs
The number of runs scored in the innings.
wickets
The number of wickets lost in the innings.
overs
The number of overs faced in the innings.
oversAvailable
The number of overs available in the innings.
conclusion
Description of how the innings finished.
teamName
The name of the team that batted in the innings.
summary
The score summary for the innings {runs}/{wickets}.
competitorId
The competitorId of the team currently batting.
isFollowOn
Boolean, indicating if the follow-on is enforced.
isFinalInnings
Boolean, indicating if it is the last Innings of the match
hasTarget
Boolean, indicating if the target of the match is confirmed.
target
The number of runs required to win the match.
batsmen
A list of type ScorecardBatsman, containing information about the batsmen for the current batting team.
extrasSummary
Member of type ScorecardExtrasSummary, representing the extras of the Innings.
fallOfWickets
A string with the fall of wicket information.
bowlers
A list of type ScorecardBowler, containing information about the batsmen for the current batting team.
ScorecardOver
overNumber
The number of the over in the innings.
runs
The number of runs scored in the over (so far).
isCurrentOver
Boolean, indicating if this is the current over.
balls
Array of strings, showing a code that indicates the score on a given ball. Runs Scored of a Ball
ScorecardExtrasSummary
wides
The number of wides in the innings
noBalls
The number of no-ball in the innings
byes
The number of byes in the innings
legByes
The number of leg byes in the innings
penalties
The number of penalties in the innings
ScorecardBatsman
batsmanName
The name of the Batsman.
active
Boolean, indicating if the Batsman is in the current partnership.
onStrike
Boolean, indicating if the Batsman will face the next ball.
fours
The number of fours the Batsman has scored in the current innings.
sixes
The number of sixes the Batsman has scored in the current innings.
runs
The number of runs the Batsman has scored in the current innings.
balls
The number of balls the Batsman has faced in the current innings.
playerId
The playerId of the player Batsman.
description
A text description of how the batsmen is out(eg: bowled, caught)
toCome
Boolean, indicating if the Batsman is yet to bet.
didNotBat
Boolean, indicating if the Batsman is batted in the innings.
fielderId
The Id of the fielder.
fielderName
The name of the Fielder
bowlerId
The bowlerId of the player Bowling.
bowlerName
The name of the Bowler
description2
A secondary description for batsmen
ScorecardBowler
bowlerName
The name of the player Bowling.
playerId
The playerId of the player Bowling.
overs
The number of overs bowled by the player
maidens
The number of maidens bowled by the player
runs
The number of runs conceded by the player
wickets
The number of wickets taken by the player
wides
The number of wides bowled by the player
noBalls
The number of noBalls bowled by the player
isActiveBowler
Boolean, indicates if the player is currently bowling
fours
The number of fours conceded by the player
sixes
The number of sixes conceded by the player
dotBalls
The number of dot balls attributed to the bowler
isOtherBowler
The bowler who bowled the previous over (empty if first over of the innings)
balls
This will cover partial overs to indicate number of balls past the overs value above
WormAndManhattan
over
The over number (1-50)
firstInnings
Comma separated string attributing runs, wickets, rolling_runs, rolling_wickets achieved during the assigned over of the first innings.
secondInnings
Comma separated string attributing runs, wickets, rolling_runs, rolling_wickets achieved during the assigned over of the second innings.
thirdInnings
Comma separated string attributing runs, wickets, rolling_runs, rolling_wickets achieved during the assigned over of the third innings.
fourthInnings
Comma separated string attributing runs, wickets, rolling_runs, rolling_wickets achieved during the assigned over of the fourth innings.
BallByBallSummary
overNumber
The over number
firstInnings
Comma separated string attributing runs of each delivery in the over for the first innings. Runs Scored of a Ball
secondInnings
Comma separated string attributing runs of each delivery in the over for the second innings.
thirdInnings
Comma separated string attributing runs of each delivery in the over for the third innings.
fourthInnings
Comma separated string attributing runs of each delivery in the over for the fourth innings.
Runs Scored of a Ball
0,1,2,3,4,6
Runs of ball
1l
Leg bye.
1b
Byes
1n
No ball
1w
Wide
w
Wicket
w1
Wicket and 1 Run
Last updated
Was this helpful?