# Scorecard

### About get\_scorecard <a href="#uofpcscorecard-aboutget_scorecard" id="uofpcscorecard-aboutget_scorecard"></a>

The get\_scorecard method is used to get a description of the current state of an In Play match. The Sportradar Event ID of the required event is passed as a parameter to the method.

### Suggested Usage <a href="#uofpcscorecard-suggestedusage" id="uofpcscorecard-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="#uofpcscorecard-requestexample" id="uofpcscorecard-requestexample"></a>

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

```
https://cricketapi.sportradar.com/UnifiedFeedScoring/xml/get_scorecard?event_id=sr:match:42096363
```

{% endtab %}

{% tab title="Staging" %}

```
https://cricketapistaging.sportradar.com/UnifiedFeedScoring/xml/get_scorecard?event_id=sr:match: 42096363
```

{% endtab %}
{% endtabs %}

### Response Structure <a href="#uofpcscorecard-responsestructure" id="uofpcscorecard-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:ScorecardMatch" 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 />
                        .....
                    </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:wormAndManhattan>
    </score>
</GetScoreResponse>
```

### Elements and Sub-elements <a href="#uofpcscorecard-elementsandsub-elements" id="uofpcscorecard-elementsandsub-elements"></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 Scorecard Over, 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                                                                                                    |

<br>

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

<br>

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

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

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

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

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

### **Enums** <a href="#uofpcscorecard-enums" id="uofpcscorecard-enums"></a>

**\<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.                                                |
| SuperOver(5)        | One over per side eliminator                                      |