> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/uof/premium-cricket/api-descriptions/scorecard.md).

# 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                                      |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sportradar.com/uof/premium-cricket/api-descriptions/scorecard.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.