> ## Documentation Index
> Fetch the complete documentation index at: https://docs.16tms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Tournaments

> Fetch a list of tournaments with optional filters.



## OpenAPI

````yaml /api-reference/tournaments/openapi.json get /tournaments
openapi: 3.0.0
info:
  title: Tournaments
  version: 1.0.0
  description: API endpoints for accessing tournaments
servers:
  - url: https://api.16tms.com/api/v1
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /tournaments:
    get:
      summary: Get Tournaments
      description: Fetch a list of tournaments with optional filters.
      operationId: getTournaments
      parameters:
        - name: GameId
          in: query
          schema:
            type: string
          description: Filter by Game ID
        - name: Status
          in: query
          schema:
            type: integer
          description: Filter by tournament status
        - name: IsFeatured
          in: query
          schema:
            type: boolean
          description: Filter by featured status
        - name: PageNumber
          in: query
          schema:
            type: integer
          description: Page number for pagination
        - name: PageSize
          in: query
          schema:
            type: integer
          description: Number of items per page
        - name: externalId
          in: query
          required: false
          schema:
            type: string
          description: >-
            External ID of the user. If provided, user-specific fields like
            'hasJoined' will be populated.
      responses:
        '200':
          description: Tournaments fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTournamentsResponse'
              example:
                success: true
                message: Tournaments fetched successfully
                data:
                  items:
                    - tournamentId: 91598fb6-12f0-4fe1-aaec-6b408ab92565
                      tournamentName: Auto Test Tournament
                      gameId: 03401d21-5109-4991-a39c-551a05bfa176
                      gameName: BGMI
                      description: >-
                        This is an auto-filled tournament used for rapid testing
                        scenarios.
                      enrollmentLimit: 32
                      maxTeamMembers: 4
                      minTeamMembers: 2
                      startTime: '2026-02-13T12:10:00Z'
                      endTime: '2026-02-15T12:10:00Z'
                      registrationDeadline: '2026-02-13T11:10:00Z'
                      registrationOpen: true
                      isOnline: true
                      status: 1
                      matchType: 2
                      teamType: squad
                      color: '#2563eb'
                      prizePool: 5000
                      entryFee: 50
                      image: null
                      coverImage: null
                      isTrending: false
                      isFeatured: true
                      isPasswordProtected: false
                      instantRegistrations: false
                      entryFeeCurrencyId: 10282b10-2b44-4bbb-9c1d-155e0bb46e79
                      entryFeeCurrencyName: d
                      entryFeeCurrencySymbol: $
                      prizePoolCurrencyId: 10282b10-2b44-4bbb-9c1d-155e0bb46e79
                      prizePoolCurrencyName: d
                      prizePoolCurrencySymbol: $
                      hasJoined: null
                      canJoin: null
                      cannotJoinReason: null
                      teamsJoinedCount: 0
                  totalCount: 1
                  pageNumber: 1
                  pageSize: 20
                  totalPages: 1
                meta:
                  traceId: 00-f125448ab05644fa80f36b22f1d71ac5-0124b07dc253ea94-00
                  elapsedMs: 70.26
                  serverTimestamp: '2026-02-12T11:21:26.4669586Z'
components:
  schemas:
    GetTournamentsResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          properties:
            items:
              type: array
              items:
                $ref: '#/components/schemas/TournamentItem'
            totalCount:
              type: integer
            pageNumber:
              type: integer
            pageSize:
              type: integer
            totalPages:
              type: integer
        meta:
          $ref: '#/components/schemas/Meta'
    TournamentItem:
      type: object
      properties:
        tournamentId:
          type: string
          example: 91598fb6-12f0-4fe1-aaec-6b408ab92565
        tournamentName:
          type: string
          example: Auto Test Tournament
        gameId:
          type: string
          example: 03401d21-5109-4991-a39c-551a05bfa176
        gameName:
          type: string
          example: BGMI
        description:
          type: string
          example: This is an auto-filled tournament used for rapid testing scenarios.
        enrollmentLimit:
          type: integer
          example: 32
        maxTeamMembers:
          type: integer
          example: 4
        minTeamMembers:
          type: integer
          example: 2
        startTime:
          type: string
          format: date-time
          example: '2026-02-13T12:10:00Z'
        endTime:
          type: string
          format: date-time
          example: '2026-02-15T12:10:00Z'
        registrationDeadline:
          type: string
          format: date-time
          example: '2026-02-13T11:10:00Z'
        registrationOpen:
          type: boolean
          example: true
        isOnline:
          type: boolean
          example: true
        status:
          type: integer
          example: 1
        matchType:
          type: integer
          example: 2
        teamType:
          type: string
          example: squad
        color:
          type: string
          example: '#2563eb'
        prizePool:
          type: number
          example: 5000
        entryFee:
          type: number
          example: 50
        image:
          type: string
          nullable: true
          example: null
        coverImage:
          type: string
          nullable: true
          example: null
        isTrending:
          type: boolean
          example: false
        isFeatured:
          type: boolean
          example: true
        isPasswordProtected:
          type: boolean
          example: false
        instantRegistrations:
          type: boolean
          example: false
        entryFeeCurrencyId:
          type: string
          example: 10282b10-2b44-4bbb-9c1d-155e0bb46e79
        entryFeeCurrencyName:
          type: string
          example: d
        entryFeeCurrencySymbol:
          type: string
          example: $
        prizePoolCurrencyId:
          type: string
          example: 10282b10-2b44-4bbb-9c1d-155e0bb46e79
        prizePoolCurrencyName:
          type: string
          example: d
        prizePoolCurrencySymbol:
          type: string
          example: $
        hasJoined:
          type: boolean
          nullable: true
          example: null
        canJoin:
          type: boolean
          nullable: true
          example: null
        cannotJoinReason:
          type: string
          nullable: true
          example: null
        teamsJoinedCount:
          type: integer
          example: 0
    Meta:
      type: object
      properties:
        traceId:
          type: string
          example: 00-f125448ab05644fa80f36b22f1d71ac5-0124b07dc253ea94-00
        elapsedMs:
          type: number
          example: 70.26
        serverTimestamp:
          type: string
          format: date-time
          example: '2026-02-12T11:21:26.4669586Z'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication.

````