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

# Commentary (v2)

> Text commentary page, filterable by innings and over range.



## OpenAPI

````yaml /openapi.json get /cricket/api/v2/match/{}/commentary
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/{}/commentary:
    get:
      tags:
        - Live Matches & Ball-by-Ball
      summary: Commentary (v2)
      description: Text commentary page, filterable by innings and over range.
      operationId: match_commentary
      parameters:
        - name: matchId
          in: path
          required: true
          description: Match identifier.
          schema:
            type: string
            example: '100123'
        - name: innings
          in: query
          required: false
          description: Innings selection.
          schema:
            type: string
            example: '1'
        - name: fromOver
          in: query
          required: false
          description: Start over (decimal).
          schema:
            type: string
            example: '1'
        - name: toOver
          in: query
          required: false
          description: End over (decimal).
          schema:
            type: string
            example: '10'
        - name: id
          in: query
          required: false
          description: Cursor/commentary id.
          schema:
            type: string
            example: ''
        - name: timeStamp
          in: query
          required: false
          description: Alternative cursor.
          schema:
            type: string
            example: ''
      responses:
        '200':
          description: Successful Response (JSON)
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
              example:
                - ballType: wicketWidget
                  ballID: '1871'
                  matchID: '98697'
                  ballNumber: '1'
                  innings: '1'
                  over: '87.1'
                  origOver: '87.1'
                  overNumber: '88'
                  commentary: Mohammad Sayyam to Jack Auld, no run, c F Yousaf b M Sayyam,
                  teamID: '1038'
                  teamName: England Under-19s
                  teamShortName: ENG-U19
                  teamImage: >-
                    https://cdn.sportxapi.com/assets/uploads/2023/05/England.png?_sxcdn=20260831
                  runs: '0'
                  batsmanID: '155829'
                  bowlerID: '152900'
                  batsmanName: Jack Auld
                  bowlerName: Mohammad Sayyam
                  wicket: true
                  type: W
                  battingStyle: null
                  currentDay: 1
                  currentSession: 1
                  matchType: TEST
                  isLastBall: false
                  summary:
                    score: 337/10
                    over: '87.1'
                    runs: 0W
                    wickets: '1'
                    batsmen:
                      - batsmanName: Jack Auld
                        onStrike: true
                        runs: '7'
                        balls: '23'
                        fours: '1'
                        sixes: '0'
                        playerID: '155829'
                        playerImage: null
                      - batsmanName: Nirvan Ramesh
                        onStrike: false
                        runs: '3'
                        balls: '20'
                        fours: '0'
                        sixes: '0'
                        playerID: '151259'
                        playerImage: null
                    bowler:
                      - bowlerName: Mohammad Sayyam
                        overs: '19.1'
                        maidens: '5'
                        runs: '60'
                        wickets: '2'
                        playerID: '152900'
                        playerImage: null
                    teamShortName: ENG-U19
                  dismissed: Jack Auld
                  wicketType: wicket
                - id: 18710
                  over: '87.1'
                  origOver: '87.1'
                  overNumber: '88'
                  ballType: ball
                  type: W
                  isBall: true
                  runs: 0W
                  bowlerName: Mohammad Sayyam
                  batsmanName: Jack Auld
                  battingStyle: null
                  commentary: Mohammad Sayyam to Jack Auld, no run, c F Yousaf b M Sayyam,
                  wicket: true
                  isLastBall: false
                  batsmanID: '155829'
                  batsmanImage: null
                  bowlerID: '152900'
                  bowlerImage: null
                  innings: '1'
                  teamID: '1038'
                  teamName: England Under-19s
                  teamShortName: ENG-U19
                  teamImage: >-
                    https://cdn.sportxapi.com/assets/uploads/2023/05/England.png?_sxcdn=20260831
        '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.