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

# Fantasy Matches

> Fantasy-relevant matches for the player.



## OpenAPI

````yaml /openapi.json get /cricket/api/v2/player/{}/fantasy/matches
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/player/{}/fantasy/matches:
    get:
      tags:
        - Players
      summary: Fantasy Matches
      description: Fantasy-relevant matches for the player.
      operationId: player_fantasy_matches
      parameters:
        - name: playerId
          in: path
          required: true
          description: Player identifier.
          schema:
            type: string
            example: '28181'
      responses:
        '200':
          description: Successful Response (JSON)
          content:
            application/json:
              schema:
                type: object
              example:
                playerID: '119'
                name: Virat Kohli
                matches:
                  - homeTeamShortName: England
                    awayTeamShortName: India
                    homeTeamID: '490'
                    awayTeamID: '25'
                    matchDate: '1784419200000'
                    matchDateFormat: 19/07/2026
                    matchID: '95162'
                    matchType: ODI
                    opposition: England vs India
                    battingStats: 74(60)
                    bowlingStats: DNB
                    homeTeamImage: >-
                      https://cdn.sportxapi.com/assets/uploads/2025/09/ENG.webp?_sxcdn=20260831
                    awayTeamImage: >-
                      https://cdn.sportxapi.com/assets/uploads/2025/09/IND.webp?_sxcdn=20260831
                  - homeTeamShortName: England
                    awayTeamShortName: India
                    homeTeamID: '490'
                    awayTeamID: '25'
                    matchDate: '1784160000000'
                    matchDateFormat: 16/07/2026
                    matchID: '95161'
                    matchType: ODI
                    opposition: England vs India
                    battingStats: 65(66)
                    bowlingStats: DNB
                    homeTeamImage: >-
                      https://cdn.sportxapi.com/assets/uploads/2025/09/ENG.webp?_sxcdn=20260831
                    awayTeamImage: >-
                      https://cdn.sportxapi.com/assets/uploads/2025/09/IND.webp?_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.