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

# Schedule (v2)

> Paginated schedule with status/type filters. status=live is served from the live cache when LIVE_CACHE_ONLY is on.



## OpenAPI

````yaml /openapi.json get /cricket/api/v2/match/schedule
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/schedule:
    get:
      tags:
        - Schedules
      summary: Schedule (v2)
      description: >-
        Paginated schedule with status/type filters. status=live is served from
        the live cache when LIVE_CACHE_ONLY is on.
      operationId: schedule_v2
      parameters:
        - name: page
          in: query
          required: false
          description: Zero-based page.
          schema:
            type: string
            example: '0'
        - name: status
          in: query
          required: false
          description: live | upcoming | completed.
          schema:
            type: string
            example: live
        - name: type
          in: query
          required: false
          description: all | international | domestic.
          schema:
            type: string
            example: all
      responses:
        '200':
          description: Successful Response (JSON)
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
              example:
                - id: 130163
                  seriesID: '130163'
                  seriesName: Pakistan U19 tour of England, 2026
                  matchType: First-class
                  type: international
                  matchCount: 1
                  matches:
                    - 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: '3'
                      firstInningsTeamID: '1148'
                      secondInningsTeamID: '1038'
                      thirdInningsTeamID: '1148'
                      fourthInningsTeamID: '1038'
                      currentInningteamID: '1148'
                      currentInningsTeamName: Pakistan Under-19s
                      matchLevel: International
                      matchName: Match 1, Pakistan U19 tour of England, 2026
                      matchNumber: Match 1
                      matchResult: null
                      matchScore:
                        - '[object]'
                        - '[object]'
                      matchStatus: live
                      matchType: First-class
                      matchdate: null
                      winningTeamID: null
                      seriesID: '130163'
                - id: 130094
                  seriesID: '130094'
                  seriesName: Womens Caribbean Premier League, 2026
                  matchType: T20
                  type: women
                  matchCount: 1
                  matches:
                    - id: 97826
                      matchID: '97826'
                      isAbandoned: false
                      homeTeamId: '125861'
                      homeTeamName: Barbados Tridents Women
                      homeTeamShortName: BT-W
                      homeTeamImg: >-
                        https://cdn.sportxapi.com/assets/uploads/2023/07/barbados-logo.png?_sxcdn=20260831
                      awayTeamId: '125862'
                      awayTeamName: Trinbago Knight Riders Women
                      awayTeamShortName: TKR-W
                      awayTeamImg: >-
                        https://cdn.sportxapi.com/assets/uploads/2023/07/trinbago-logo.png?_sxcdn=20260831
                      currentinningsNo: '1'
                      firstInningsTeamID: '125862'
                      secondInningsTeamID: null
                      thirdInningsTeamID: null
                      fourthInningsTeamID: null
                      currentInningteamID: '125862'
                      currentInningsTeamName: Trinbago Knight Riders Women
                      matchLevel: null
                      matchName: Match 1, Womens Caribbean Premier League, 2026
                      matchNumber: Match 1
                      matchResult: null
                      matchScore:
                        - '[object]'
                        - '[object]'
                      matchStatus: live
                      matchType: T20
                      matchdate: null
                      winningTeamID: null
                      seriesID: '130094'
        '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: []

````

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