> ## Documentation Index
> Fetch the complete documentation index at: https://docsv2.sportxapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Live Score

> Realtime score payload for a live match, including overs, run-rate, and phase.



## OpenAPI

````yaml /openapi.json get /cricket/api/v2/match/{}/live
openapi: 3.1.0
info:
  title: SportXAPI Cricket API
  version: 2.0.0
  description: >-
    SportXAPI is a low-latency cricket data API delivering realtime ball-by-ball
    commentary, live scores, detailed match scorecards, tournaments, team/player
    statistics, ICC rankings, and news.
servers:
  - url: https://apiv2.sportxapi.com
    description: Production API (Paid keys)
  - url: https://api.sportxapi.com
    description: Demo & Testing API (Free/Demo tier)
security: []
paths:
  /cricket/api/v2/match/{}/live:
    get:
      tags:
        - Live Matches & Ball-by-Ball
      summary: Live Score
      description: >-
        Realtime score payload for a live match, including overs, run-rate, and
        phase.
      operationId: match_live
      parameters:
        - name: matchId
          in: path
          required: true
          description: Match identifier.
          schema:
            type: string
            example: '100123'
        - name: innings
          in: query
          required: false
          description: Innings index (all / 1 / 2).
          schema:
            type: string
            example: all
      responses:
        '200':
          description: Successful Response (JSON)
          content:
            application/json:
              schema:
                type: object
              example:
                matchID: '98697'
                miniScore:
                  batting:
                    - matchID: '98697'
                      playerID: '144919'
                      playerImage: >-
                        https://cdn.sportxapi.com/assets/uploads/2026/04/rizwanullah-murad.png?_sxcdn=20260831
                      playerName: Rizwanullah
                      playerShortName: Rizwanullah
                      playerTeam: Pakistan Under-19s
                      battingStyle: null
                      playerMatchStrikeRate: '0.00'
                      playerOnStrike: true
                      playerMatchBalls: '1'
                      runs: '0'
                      sixes: '0'
                      fours: '0'
                      playerDismissalInfo: c Ralphie Albert b Jack Nelson
                      isSubstituted: false
                      isSuperSub: false
                      playerOut: null
                      playerOutName: null
                      playerIn: null
                      playerInName: null
                    - matchID: '98697'
                      playerID: '133230'
                      playerImage: null
                      playerName: Mohammad Huzaifa
                      playerShortName: Mohammad Huzaifa
                      playerTeam: Pakistan Under-19s
                      battingStyle: null
                      playerMatchStrikeRate: '0.00'
                      playerOnStrike: false
                      playerMatchBalls: '7'
                      runs: '0'
                      sixes: '0'
                      fours: '0'
                      playerDismissalInfo: c Ralphie Albert b Jack Nelson
                      isSubstituted: false
                      isSuperSub: false
                      playerOut: null
                      playerOutName: null
                      playerIn: null
                      playerInName: null
                  bowling:
                    - matchID: '98697'
                      playerID: '151946'
                      playerImage: null
                      playerFeedID: null
                      playerName: Jack Nelson
                      playerTeam: England Under-19s
                      wickets: '4'
                      maiden: '0'
                      runsConceeded: '36'
                      overs: '7.1'
                      economy: '5.02'
                  partnership: (7)
                  oversRemaining: '0.0'
                  ballsRemaining: '0'
                  reviewDetails:
                    - teamName: Pakistan Under-19s
                      review: '0'
                    - teamName: England Under-19s
                      review: '0'
                  runRate: '4.07'
                  rRunRate: '0.00'
                  liveScoreUrl: PAK-U19-253/10-(62.1)
                  data:
                    - id: 98697
                      matchID: '98697'
                      isAbandoned: false
                      homeTeamId: '1038'
                      homeTeamName: England Under-19s
                      homeTeamShortName: ENG-U19
                      homeTeamImg: >-
                        https://cdn.sportxapi.com/assets/uploads/2023/05/England.png?_sxcdn=20260831
                      awayTeamId: '1148'
                      awayTeamName: Pakistan Under-19s
                      awayTeamShortName: PAK-U19
                      awayTeamImg: >-
                        https://cdn.sportxapi.com/assets/uploads/2023/05/Pakistan.png?_sxcdn=20260831
                      currentinningsNo: '4'
                      firstInningsTeamID: '1038'
                      secondInningsTeamID: '1148'
                      thirdInningsTeamID: null
                      fourthInningsTeamID: null
                      currentInningteamID: '1148'
                      currentInningsTeamName: Pakistan Under-19s
                      matchLevel: International
                      matchName: 1st Match, Pakistan U19 tour of England, 2026
                      matchNumber: 1st Match
                      matchResult: null
                      matchScore:
                        - '[object]'
                        - '[object]'
                      matchStatus: live
                      matchType: Test
                      matchdate: null
                      winningTeamID: null
                      seriesID: '130163'
                last12Balls:
                  - overNumber: '1'
                    over:
                      - isWicket: 'false'
                        isBall: 'true'
                        isLastBall: 'false'
                        overNumber: '1'
                        runs: '0'
                        type: null
                      - isWicket: 'false'
                        isBall: 'true'
                        isLastBall: 'false'
                        overNumber: '1'
                        runs: '1'
                        type: null
                  - overNumber: '2'
                    over:
                      - isWicket: 'false'
                        isBall: 'true'
                        isLastBall: 'false'
                        overNumber: '2'
                        runs: '0'
                        type: null
                      - isWicket: 'false'
                        isBall: 'true'
                        isLastBall: 'false'
                        overNumber: '2'
                        runs: '0'
                        type: null
        '401':
          description: Unauthorized - Missing or invalid X-API-Key header
          content:
            application/json:
              example:
                error: 'Unauthorized: Missing or invalid API key'
        '429':
          description: Too Many Requests - Rate limit or monthly quota exceeded
          content:
            application/json:
              example:
                error: Quota limit exceeded for current billing cycle
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your SportXAPI secret key from the customer dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.