# Score by Ball

### About get\_premiumscorecard <a href="#uofpcscorebyball-aboutget_premiumscorecard" id="uofpcscorebyball-aboutget_premiumscorecard"></a>

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 <a href="#uofpcscorebyball-suggestedusage" id="uofpcscorebyball-suggestedusage"></a>

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 <a href="#uofpcscorebyball-requestexample" id="uofpcscorebyball-requestexample"></a>

{% tabs %}
{% tab title="Production" %}

```
https://cricketapi.sportradar.com/UnifiedFeedScoring/json/get_premiumscorecard?event_Id=sr:match:42096363
```

{% endtab %}

{% tab title="Staging" %}

```
https://cricketapistaging.sportradar.com/UnifiedFeedScoring/xml/get_premiumscorecard?event_ id=sr:match:42096363
```

{% endtab %}
{% endtabs %}

### Response Structure <a href="#uofpcscorebyball-responsestructure" id="uofpcscorebyball-responsestructure"></a>

```xml
<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 <a href="#uofpcscorebyball-elementsandsub-elementsexplained" id="uofpcscorebyball-elementsandsub-elementsexplained"></a>

1. **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 |

<br>

2. **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                                                                                                    |

<br>

3. **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.                                               |

<br>

4. **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 ScorecardExtrasSummar&#x79;**,** 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. |

5. **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 |

<br>

6. **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 |

<br>

7. **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                                       |

<br>

8. **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 |

<br>

9. **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. |

<br>

10. **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.                      |

<br>

11. **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 |

<br>