> For the complete documentation index, see [llms.txt](https://docs.thesports.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thesports.com/cricket/match-data/statistical-data-historical-matches.md).

# Statistical data(historical matches)

## Statistical data(historical matches)

> Return the scores data, round score timeline and player statistics for completed historical matches\<br/>Request times: 120 times/min

```json
{"openapi":"3.0.1","info":{"title":"Cricket API","version":"1.0.250818"},"tags":[{"name":"MATCH DATA","description":"MATCH DATA"}],"servers":[{"url":"https://api.thesports.com"}],"paths":{"/v1/cricket/match/live/history":{"get":{"tags":["MATCH DATA"],"description":"Return the scores data, round score timeline and player statistics for completed historical matches<br/>Request times: 120 times/min","summary":"Statistical data(historical matches)","operationId":"getMatchLiveHistory","parameters":[{"$ref":"#/components/parameters/User"},{"$ref":"#/components/parameters/Secret"},{"name":"uuid","in":"query","description":"Match id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"results":{"$ref":"#/components/schemas/MatchDetailLive"}}}}}},"404":{"$ref":"#/components/responses/404NotFound"}}}}},"components":{"parameters":{"User":{"name":"user","in":"query","description":"Username, please contact business","required":true,"schema":{"type":"string"}},"Secret":{"name":"secret","in":"query","description":"Key, please contact business","required":true,"schema":{"type":"string"}}},"schemas":{"MatchDetailLive":{"type":"object","description":"Data details","properties":{"id":{"type":"string","description":"Match id"},"score":{"$ref":"#/deps/schemas/LiveScore"},"timeline":{"type":"array","description":"Real-time round score","items":{"$ref":"#/components/schemas/TimeLine"}},"players":{"type":"array","description":"Player statistics","items":{"$ref":"#/components/schemas/LiveScorecard"}}}},"TimeLine":{"type":"object","properties":{"inning":{"type":"integer","description":"Innings, 1-first inning, 2-second inning, and so on"},"team_id":{"type":"string","description":"Batting team id"},"overs":{"type":"array","description":"Rounds and balls","items":{"$ref":"#/deps/schemas/TimeLineRound"}},"wickets":{"type":"array","description":"Wickets","items":{"$ref":"#/deps/schemas/TimeLineWicket"}},"players":{"type":"array","description":"Rounds and players","items":{"$ref":"#/deps/schemas/TimeLinePlayer"}}}},"LiveScorecard":{"type":"object","properties":{"inning":{"type":"integer","description":"Innings, 1-first inning, 2-second inning, and so on"},"batting":{"type":"object","description":"Batting side statistics","properties":{"team_id":{"type":"string","description":"Batting team id"},"runs":{"type":"integer","description":"Team score"},"balls_faced":{"type":"integer","description":"Number of team battings"},"fours":{"type":"integer","description":"Number of team 4 points balls"},"sixes":{"type":"integer","description":"Number of team 6 points balls"},"players":{"type":"array","description":"Player statistics","items":{"$ref":"#/deps/schemas/LiveScorecardBatPlayer"}},"extra":{"type":"array","description":"Player Stat Correlation","items":{"$ref":"#/deps/schemas/LiveScorecardBatExtra"}}}},"bowling":{"type":"object","description":"Pitching side statistics","properties":{"team_id":{"type":"string","description":"Pitching team id"},"wides":{"type":"integer","description":"Team wides"},"byes":{"type":"integer","description":"Team byes"},"leg_byes":{"type":"integer","description":"Team leg_byes"},"penalty":{"type":"integer","description":"Team penalty"},"no_balls":{"type":"integer","description":"Team no_balls"},"extra":{"type":"integer","description":"Additional score(lose score)"},"players":{"type":"array","description":"Player statistics","items":{"$ref":"#/deps/schemas/LiveScorecardBowlPlayer"}}}}}}},"responses":{"404NotFound":{"description":"Resource does not exist","content":{"application/json":{"schema":{"$ref":"#/common/schemas/ErrorMsg"}}}}}},"deps":{"schemas":{"LiveScore":{"type":"array","description":"Score data<br/>example: [\"dn1m1kck8kozqoe\", 100, 0, {\"p1\": [275, 271], \"ft\": [275, 271]}, {\"innings\": [[2, 271, 50.0, 6], [1, 275, 48.2, 5]], \"results\": {\"winby\": 2, \"margin\": 5}}]\n\n**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Match id | String |\n| `1` | Match status, please refer to Status code->Match state | Integer |\n| `2` | Batting team, 1. Home team, 2. Away team, 0. Unknown | Integer |\n| `3` | Detailed instructions, as above 0 | Not specified |\n| `4` | Detailed instructions, as above 1 | Not specified |\n","properties":[{"$ref":"#/deps/schemas/Score"},{"$ref":"#/deps/schemas/LiveInning"}],"items":""},"Score":{"type":"object","description":"Score data (May be empty)<br/>ft - Total score<br/>p* - Single inning score(* - Number of inning, 1, 2, 3...)","properties":{"ft":{"$ref":"#/deps/schemas/MatchScore"},"p*":{"$ref":"#/deps/schemas/MatchScore"}}},"MatchScore":{"type":"array","items":"","description":"**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Home team score | Integer |\n| `1` | Away team score | Integer |\n"},"LiveInning":{"type":"object","description":"Single inning details and winning method (May be empty)","properties":{"innings":{"type":"array","description":"Single inning details","items":{"$ref":"#/deps/schemas/ExtraInning"}},"results":{"type":"object","description":"Winning method (Field may not exist)","properties":{"winby":{"type":"integer","description":"Way to win, 1. runs, 2. wickets, 3. innings, 0. none(appears in a tie)"},"margin":{"type":"integer","description":"Difference (runs/wickets)"},"result":{"type":"integer","description":"Match result, 1. home won, 2. away won, 3. draw, 0. No result(canceled, not started, postponed, etc.) (Field may not exist)"}}}}},"ExtraInning":{"type":"array","description":"Data details<br/>example: [[2, 192, 20, 3], [1, 156, 20, 10]]\n\n**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Team, 1. Home team, 2. Away team | Integer |\n| `1` | Run score | Integer |\n| `2` | Number of rounds eg: '50':Round 50, '39.5':Round 39 + 5 balls, the 5th ball in the 40th round | Integer/Float |\n| `3` | Number of people eliminated | Integer |\n","items":""},"TimeLineRound":{"type":"array","description":"Field description<br/>example: [[6, 3, 1, 0, ''], [6, 4, 0, 1, 'WD']]\n\n**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Rounds, 1-first round, 2-second round, and so on | Integer |\n| `1` | Balls, 1-first ball, 2-second ball, and so on | Integer |\n| `2` | Score | Integer |\n| `3` | Extra scores | Integer |\n| `4` | Extra scores description, WD-wides, B-byes, NB-no_balls, LB-leg_byes, P-penalty | String |\n","items":""},"TimeLineWicket":{"type":"array","description":"Field description<br/>example: [[2, 5], [6, 1]]\n\n**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Rounds, 1-first round, 2-second round, and so on | Integer |\n| `1` | Balls, 1-first ball, 2-second ball, and so on | Integer |\n","items":""},"TimeLinePlayer":{"type":"array","description":"Round Player Field Description<br/>example: [[2, 1, \"4wyrnyc2494q86p\", \"zp5rzpc2468q82w\", \"ednm96cddoymyox\", 0, 0, 0, 0, 0]]\n\n**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Rounds, 1-first round, 2-second round, and so on | Integer |\n| `1` | Balls, 1-first ball, 2-second ball, and so on | Integer |\n| `2` | Pitching player id | String |\n| `3` | Batting player id (current batting) | String |\n| `4` | Batting player id (currently not batting) | String |\n| `5` | Placeholder, ignore | Not specified |\n| `6` | Placeholder, ignore | Not specified |\n| `7` | Placeholder, ignore | Not specified |\n| `8` | Placeholder, ignore | Not specified |\n| `9` | Placeholder, ignore | Not specified |\n","items":""},"LiveScorecardBatPlayer":{"type":"array","description":"Field description<br/>example: [[\"l5ergec58l8m8k0\", 64, 42, 6, 4, '152.38'], [\"965mkzcgndxm1ge\", 6, 1, 0, 1, '600']]\n\n**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Player id | String |\n| `1` | Score | Integer |\n| `2` | Number of battings | Integer |\n| `3` | Number of 4 points balls | Integer |\n| `4` | Number of 6 points balls | Integer |\n| `5` | Scoring rate | String |\n","items":""},"LiveScorecardBatExtra":{"type":"array","description":"Player Statistics Association Field Description<br/>example: [[\"965mkzcgo3pm1ge\", 2, \"dn1m1kcol62qoep\", \"3glrwocl34zmdyj\", 0, 0, 0, 0, 0]]\n\n**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Player id | String |\n| `1` | Elimination type id, see Status Code -> Elimination Type | Integer |\n| `2` | Pitching player id | String |\n| `3` | Outfield Player id | String |\n| `4` | Placeholder, ignore | Not specified |\n| `5` | Placeholder, ignore | Not specified |\n| `6` | Placeholder, ignore | Not specified |\n| `7` | Placeholder, ignore | Not specified |\n| `8` | Placeholder, ignore | Not specified |\n","items":""},"LiveScorecardBowlPlayer":{"type":"array","description":"Field description<br/>example: [[\"y39mpxck441rojx\", 2, 0, 25, 0, '12.5'], [\"jw2r0kcp066qz84\", 4.2, 0, 49, 0, '12.25']]\n\n**Field definitions**\n\n| Index | Field | Type |\n| --- | --- | --- |\n| `0` | Player id | String |\n| `1` | Number of rounds played | Integer/Float |\n| `2` | Number of innocent rounds | Integer |\n| `3` | Lose score | Integer |\n| `4` | Elimination number | Integer |\n| `5` | Lose score per round | String |\n","items":""}}},"common":{"schemas":{"ErrorMsg":{"type":"object","description":"abnormal","properties":{"code":{"type":"integer","description":"status code"},"msg":{"type":"string","description":"Error message"}}}}}}
```


---

# 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.thesports.com/cricket/match-data/statistical-data-historical-matches.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.