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

# Match Details

> Structured details (venue, toss, officials, squad context).



## OpenAPI

````yaml /openapi.json get /cricket/api/v2/match/{}/details
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/{}/details:
    get:
      tags:
        - Live Matches & Ball-by-Ball
      summary: Match Details
      description: Structured details (venue, toss, officials, squad context).
      operationId: match_details
      parameters:
        - name: matchId
          in: path
          required: true
          description: Match identifier.
          schema:
            type: string
            example: '100123'
      responses:
        '200':
          description: Successful Response (JSON)
          content:
            application/json:
              schema:
                type: object
              example:
                seriesName: Pakistan U19 tour of England, 2026
                seriesID: '130163'
                homeTeamID: '1038'
                homeTeamName: England Under-19s
                homeTeamShortName: ENG-U19
                homeTeamImage: >-
                  https://cdn.sportxapi.com/assets/uploads/2023/05/England.png?_sxcdn=20260831
                awayTeamID: '1148'
                awayTeamName: Pakistan Under-19s
                awayTeamShortName: PAK-U19
                awayTeamImage: >-
                  https://cdn.sportxapi.com/assets/uploads/2023/05/Pakistan.png?_sxcdn=20260831
                date: '1788600600000'
                matchOrder: 1st Match
                toss: England Under-19s won the toss and elected to bat first
                venue: Arundel Castle Cricket Club Ground
                venueID: '56'
                type: International
                umpires: Ben Debenham (ENG), Mark Newell (ENG)
                thirdUmpire: null
                matchReferee: null
                homePlayingXI:
                  - pos: 1
                    playerID: '155827'
                    playerName: Bertie Michael
                    playerNameShort: Bertie Michael
                    playerRole: Batsman
                    playerClubId: '1038'
                    playerClubName: ENG-U19
                    playerImage: null
                    captain: false
                  - pos: 2
                    playerID: '150040'
                    playerName: R Albert
                    playerNameShort: R Albert
                    playerRole: All-Rounder
                    playerClubId: '1038'
                    playerClubName: ENG-U19
                    playerImage: null
                    captain: true
                awayPlayingXI:
                  - pos: 1
                    playerID: '152902'
                    playerName: Hamza Zahoor
                    playerNameShort: H Zahoor
                    playerRole: Wicket Keeper
                    playerClubId: '1148'
                    playerClubName: PAK-U19
                    playerImage: >-
                      https://cdn.sportxapi.com/assets/uploads/2026/04/hamza-zahoor.png?_sxcdn=20260831
                    captain: false
                  - pos: 2
                    playerID: '120291'
                    playerName: Farhan Yousaf
                    playerNameShort: F Yousaf
                    playerRole: Batsman
                    playerClubId: '1148'
                    playerClubName: PAK-U19
                    playerImage: >-
                      https://cdn.sportxapi.com/assets/uploads/2026/04/farhan-yousaf.png?_sxcdn=20260831
                    captain: true
                venueDetails:
                  venueId: '56'
                  venueLat: null
                  venueLong: null
                  city: Arundel
                  name: Arundel Castle Cricket Club Ground
                  established: null
                  capacity: null
                  country: England
                  overall:
                    averageFirstInningsScore: '289'
                    averageInningsScore: '289'
                    averageSecondInningsScore: '278'
                    batFirst:
                      abandoned: '0'
                      batFirstPercentage: '62.5'
                      lost: null
                      matchesPlayed: '9'
                      noresult: '0'
                      tied: '0'
                      winPercentage: '62.5'
                      won: null
                    bowlFirst:
                      abandoned: '0'
                      bowlFirstPercentage: '37.5'
                      lost: null
                      matchesPlayed: '9'
                      noresult: '0'
                      tied: '0'
                      winPercentage: '37.5'
                      won: null
                    highestScoreAtVenue: '552'
                    pacerStats: null
                    pitchBatBowlConditionDesc: null
                    pitchBatBowlConditionId: null
                    pitchForSpinPace: null
                    spinnerStats: null
                    teamStats: []
                    tossWinner: null
                weatherConditions:
                  weatherId: null
                  weather: null
                  description: null
                  humidity: null
                  temperature: null
                  visibility: null
                  windSpeed: null
                recentPerformance:
                  - id: '1038'
                    lastFiveMatches:
                      - id: '97710'
                        displayOutput: null
                        result: Match Drawn
                        resultShort: Match Drawn
                        venueId: '47'
                        venueName: County Ground, Hove
                        venueCity: Brighton
                        winnerTeamId: null
                        winnerTeamName: South Africa Under-19s
                        loserTeamId: null
                        loserTeamName: null
                        winBy: null
                        marginValue: null
                        matchPlayer: null
                        matchStartDate: 17-07-2026
                        matchEndDate: 22-07-2026
                        againstTeamId: '1012'
                        againstTeamName: South Africa Under-19s
                        againstTeamShortName: SA-U19
                        againstTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/South-africa.png?_sxcdn=20260831
                        homeTeamId: '1038'
                        homeTeamName: England Under-19s
                        homeTeamShortName: ENG-U19
                        homeTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/England.png?_sxcdn=20260831
                        awayTeamId: '1012'
                        awayTeamName: South Africa Under-19s
                        awayTeamShortName: SA-U19
                        awayTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/South-africa.png?_sxcdn=20260831
                      - id: '97709'
                        displayOutput: null
                        result: >-
                          South Africa Under-19s beat England Under-19s by 45
                          runs
                        resultShort: SA-U19 won by 45 runs
                        venueId: '55'
                        venueName: The Kent County Cricket Ground
                        venueCity: Beckenham
                        winnerTeamId: '1012'
                        winnerTeamName: South Africa Under-19s
                        loserTeamId: '1038'
                        loserTeamName: England Under-19s
                        winBy: r
                        marginValue: 45 runs
                        matchPlayer: null
                        matchStartDate: 10-07-2026
                        matchEndDate: 15-07-2026
                        againstTeamId: '1012'
                        againstTeamName: South Africa Under-19s
                        againstTeamShortName: SA-U19
                        againstTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/South-africa.png?_sxcdn=20260831
                        homeTeamId: '1038'
                        homeTeamName: England Under-19s
                        homeTeamShortName: ENG-U19
                        homeTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/England.png?_sxcdn=20260831
                        awayTeamId: '1012'
                        awayTeamName: South Africa Under-19s
                        awayTeamShortName: SA-U19
                        awayTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/South-africa.png?_sxcdn=20260831
                  - id: '1148'
                    lastFiveMatches:
                      - id: '70470'
                        displayOutput: null
                        result: >-
                          Pakistan Under-19s beat Sri Lanka Under-19s by 9
                          wickets
                        resultShort: PAK-U19 won by 9 wickets
                        venueId: '261'
                        venueName: National Bank of Pakistan Sports Complex
                        venueCity: Karachi
                        winnerTeamId: '1148'
                        winnerTeamName: Pakistan Under-19s
                        loserTeamId: '1121'
                        loserTeamName: Sri Lanka Under-19s
                        winBy: w
                        marginValue: 9 wickets
                        matchPlayer: null
                        matchStartDate: 15-10-2023
                        matchEndDate: 20-10-2023
                        againstTeamId: '1121'
                        againstTeamName: Sri Lanka Under-19s
                        againstTeamShortName: SL-U19
                        againstTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/Sri-lanka.png?_sxcdn=20260831
                        homeTeamId: '1148'
                        homeTeamName: Pakistan Under-19s
                        homeTeamShortName: PAK-U19
                        homeTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/Pakistan.png?_sxcdn=20260831
                        awayTeamId: '1121'
                        awayTeamName: Sri Lanka Under-19s
                        awayTeamShortName: SL-U19
                        awayTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/Sri-lanka.png?_sxcdn=20260831
                      - id: '62591'
                        displayOutput: null
                        result: >-
                          Pakistan Under-19s beat Bangladesh Under-19s by 10
                          wickets
                        resultShort: PAK-U19 won by 10 wickets
                        venueId: '113'
                        venueName: Zahur Ahmed Chowdhury Stadium
                        venueCity: Chattogram
                        winnerTeamId: '1148'
                        winnerTeamName: Pakistan Under-19s
                        loserTeamId: '1010'
                        loserTeamName: Bangladesh Under-19s
                        winBy: w
                        marginValue: 10 wickets
                        matchPlayer: null
                        matchStartDate: 30-04-2023
                        matchEndDate: 05-05-2023
                        againstTeamId: '1010'
                        againstTeamName: Bangladesh Under-19s
                        againstTeamShortName: BAN-U19
                        againstTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/Bangladesh-10.png?_sxcdn=20260831
                        homeTeamId: '1010'
                        homeTeamName: Bangladesh Under-19s
                        homeTeamShortName: BAN-U19
                        homeTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/Bangladesh-10.png?_sxcdn=20260831
                        awayTeamId: '1148'
                        awayTeamName: Pakistan Under-19s
                        awayTeamShortName: PAK-U19
                        awayTeamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2023/05/Pakistan.png?_sxcdn=20260831
                head2head: []
        '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.