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

# Team Statistics

> Aggregated statistics for the team.



## OpenAPI

````yaml /openapi.json get /cricket/api/v2/team/{}/stats
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/team/{}/stats:
    get:
      tags:
        - Teams & Venues
      summary: Team Statistics
      description: Aggregated statistics for the team.
      operationId: team_stats
      parameters:
        - name: teamId
          in: path
          required: true
          description: Team identifier.
          schema:
            type: string
            example: '101'
      responses:
        '200':
          description: Successful Response (JSON)
          content:
            application/json:
              schema:
                type: object
              example:
                teamID: '25'
                teamName: India
                teamImage: >-
                  https://cdn.sportxapi.com/assets/uploads/2025/09/IND.webp?_sxcdn=20260831
                squadCount: 0
                roleCounts:
                  bATSMAN: 0
                  bOWLER: 0
                  aLLROUNDER: 0
                  wICKETKEEPER: 0
                rankings:
                  - rankType: ranks
                    format: odi
                    group: all-rounders
                    rank: null
                    pid: '125'
                    player: Ravindra Jadeja
                    team: null
                    rating: '167'
                    updated: 0
                    rankString: '19'
                    playerLogoUrl: >-
                      https://cdn.sportxapi.com/assets/uploads/2026/04/ravindra-jadeja.png?_sxcdn=20260831
                  - rankType: ranks
                    format: odi
                    group: all-rounders
                    rank: null
                    pid: '775'
                    player: Kuldeep Yadav
                    team: null
                    rating: '146'
                    updated: 0
                    rankString: '30'
                    playerLogoUrl: >-
                      https://cdn.sportxapi.com/assets/uploads/2026/04/kuldeep-yadav.png?_sxcdn=20260831
                series:
                  - seriesId: 129532
                    seriesname: India Tour of Australia
                    seriesShortDisplayName: AUS vs IND
                    seriesType: mixed
                    seriesStartDate: '2025-10-19'
                    seriesEndDate: '2025-11-08'
                  - seriesId: 129533
                    seriesname: West Indies Tour of India
                    seriesShortDisplayName: IND vs WI
                    seriesType: test
                    seriesStartDate: '2025-10-02'
                    seriesEndDate: '2025-10-15'
                recentMatches:
                  - id: 98356
                    matchID: '98356'
                    isAbandoned: false
                    homeTeamId: '498'
                    homeTeamName: Afghanistan
                    homeTeamShortName: AFG
                    homeTeamImg: >-
                      https://cdn.sportxapi.com/assets/uploads/2025/09/AF.webp?_sxcdn=20260831
                    awayTeamId: '25'
                    awayTeamName: India
                    awayTeamShortName: IND
                    awayTeamImg: >-
                      https://cdn.sportxapi.com/assets/uploads/2025/09/IND.webp?_sxcdn=20260831
                    currentinningsNo: null
                    firstInningsTeamID: null
                    secondInningsTeamID: null
                    thirdInningsTeamID: null
                    fourthInningsTeamID: null
                    currentInningteamID: null
                    currentInningsTeamName: null
                    matchLevel: International
                    matchName: Match 1, Afghanistan vs India in India, 2026
                    matchNumber: Match 1
                    matchResult: null
                    matchScore:
                      - teamID: '498'
                        teamFullName: Afghanistan
                        teamShortName: AFG
                        teamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2025/09/AF.webp?_sxcdn=20260831
                        teamScore: []
                      - teamID: '25'
                        teamFullName: India
                        teamShortName: IND
                        teamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2025/09/IND.webp?_sxcdn=20260831
                        teamScore: []
                    matchStatus: upcoming
                    matchType: T20
                    matchdate: null
                    winningTeamID: null
                    seriesID: '130140'
                  - id: 98357
                    matchID: '98357'
                    isAbandoned: false
                    homeTeamId: '498'
                    homeTeamName: Afghanistan
                    homeTeamShortName: AFG
                    homeTeamImg: >-
                      https://cdn.sportxapi.com/assets/uploads/2025/09/AF.webp?_sxcdn=20260831
                    awayTeamId: '25'
                    awayTeamName: India
                    awayTeamShortName: IND
                    awayTeamImg: >-
                      https://cdn.sportxapi.com/assets/uploads/2025/09/IND.webp?_sxcdn=20260831
                    currentinningsNo: null
                    firstInningsTeamID: null
                    secondInningsTeamID: null
                    thirdInningsTeamID: null
                    fourthInningsTeamID: null
                    currentInningteamID: null
                    currentInningsTeamName: null
                    matchLevel: International
                    matchName: Match 2, Afghanistan vs India in India, 2026
                    matchNumber: Match 2
                    matchResult: null
                    matchScore:
                      - teamID: '498'
                        teamFullName: Afghanistan
                        teamShortName: AFG
                        teamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2025/09/AF.webp?_sxcdn=20260831
                        teamScore: []
                      - teamID: '25'
                        teamFullName: India
                        teamShortName: IND
                        teamImage: >-
                          https://cdn.sportxapi.com/assets/uploads/2025/09/IND.webp?_sxcdn=20260831
                        teamScore: []
                    matchStatus: upcoming
                    matchType: T20
                    matchdate: null
                    winningTeamID: null
                    seriesID: '130140'
        '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.