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

# Men (v3)

> Mens individual rankings — versioned endpoint.



## OpenAPI

````yaml /openapi.json get /cricket/api/v3/ranking/men
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/v3/ranking/men:
    get:
      tags:
        - Rankings
      summary: Men (v3)
      description: Mens individual rankings — versioned endpoint.
      operationId: ranking_men_v3
      parameters: []
      responses:
        '200':
          description: Successful Response (JSON)
          content:
            application/json:
              schema:
                type: object
              example:
                oDI:
                  - matchType: ODI
                    gender: male
                    rankType: allrounder
                    updatedAt: null
                    rank:
                      - position: '1'
                        change: ( - )
                        playerName: Azmatullah Omarzai
                        playerID: '67516'
                        countryId: '262'
                        countryName: Afghanistan
                        country: AFG
                        teamID: '1188'
                        teamName: Afghanistan
                        points: '337'
                        careerbest: 337 v Ireland at Belfast 2026
                        rankdate: '2026-08-18'
                      - position: '2'
                        change: ( - )
                        playerName: Mehidy Hasan Miraz
                        playerID: '63875'
                        countryId: '2'
                        countryName: Bangladesh
                        country: BAN
                        teamID: '2'
                        teamName: Bangladesh
                        points: '260'
                        careerbest: 285 v India at Mirpur 2022
                        rankdate: '2026-08-18'
                  - matchType: ODI
                    gender: male
                    rankType: bat
                    updatedAt: null
                    rank:
                      - position: '1'
                        change: ( - )
                        playerName: Shubman Gill
                        playerID: '66818'
                        countryId: '4'
                        countryName: India
                        country: IND
                        teamID: '4'
                        teamName: India
                        points: '801'
                        careerbest: 841 v Australia at Indore 2023
                        rankdate: '2026-08-18'
                      - position: '2'
                        change: ( - )
                        playerName: Daryl Mitchell
                        playerID: '57444'
                        countryId: '5'
                        countryName: New Zealand
                        country: NZ
                        teamID: '5'
                        teamName: New Zealand
                        points: '794'
                        careerbest: 840 v India at Indore 2026
                        rankdate: '2026-08-18'
                test:
                  - matchType: Test
                    gender: male
                    rankType: allrounder
                    updatedAt: null
                    rank:
                      - position: '1'
                        change: ( - )
                        playerName: Ravindra Jadeja
                        playerID: '3850'
                        countryId: '4'
                        countryName: India
                        country: IND
                        teamID: '4'
                        teamName: India
                        points: '422'
                        careerbest: 475 v Bangladesh at Chennai 2024
                        rankdate: '2026-09-01'
                      - position: '2'
                        change: ( - )
                        playerName: Marco Jansen
                        playerID: '69409'
                        countryId: '7'
                        countryName: South Africa
                        country: SA
                        teamID: '7'
                        teamName: South Africa
                        points: '344'
                        careerbest: 344 v India at Guwahati 2025
                        rankdate: '2026-09-01'
                  - matchType: Test
                    gender: male
                    rankType: bat
                    updatedAt: null
                    rank:
                      - position: '1'
                        change: ( - )
                        playerName: Harry Brook
                        playerID: '66374'
                        countryId: '3'
                        countryName: England
                        country: ENG
                        teamID: '3'
                        teamName: England
                        points: '856'
                        careerbest: 898 v New Zealand at Wellington 2024
                        rankdate: '2026-09-01'
                      - position: '2'
                        change: (+1)
                        playerName: Steve Smith
                        playerID: '4308'
                        countryId: '1'
                        countryName: Australia
                        country: AUS
                        teamID: '1'
                        teamName: Australia
                        points: '840'
                        careerbest: 947 v South Africa at Durban 2018
                        rankdate: '2026-09-01'
                t20:
                  - matchType: T20
                    gender: male
                    rankType: allrounder
                    updatedAt: null
                    rank:
                      - position: '1'
                        change: ( - )
                        playerName: Sikandar Raza
                        playerID: '25422'
                        countryId: '10'
                        countryName: Zimbabwe
                        country: ZIM
                        teamID: '10'
                        teamName: Zimbabwe
                        points: '316'
                        careerbest: 339 v Bangladesh at Bulawayo 2026
                        rankdate: '2026-09-01'
                      - position: '2'
                        change: ( - )
                        playerName: Saim Ayub
                        playerID: '70241'
                        countryId: '6'
                        countryName: Pakistan
                        country: PAK
                        teamID: '6'
                        teamName: Pakistan
                        points: '275'
                        careerbest: 303 v India at Colombo (RPS) 2026
                        rankdate: '2026-09-01'
                  - matchType: T20
                    gender: male
                    rankType: bat
                    updatedAt: null
                    rank:
                      - position: '1'
                        change: ( - )
                        playerName: Ishan Kishan
                        playerID: '64712'
                        countryId: '4'
                        countryName: India
                        country: IND
                        teamID: '4'
                        teamName: India
                        points: '910'
                        careerbest: 916 v Zimbabwe at Harare 2026
                        rankdate: '2026-09-01'
                      - position: '2'
                        change: ( - )
                        playerName: Sahibzada Farhan
                        playerID: '64076'
                        countryId: '6'
                        countryName: Pakistan
                        country: PAK
                        teamID: '6'
                        teamName: Pakistan
                        points: '848'
                        careerbest: 848 v Sri Lanka at Pallekele 2026
                        rankdate: '2026-09-01'
        '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.