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

# List Outrights

> List outright tournaments with the number of bookmakers pricing each. Golf first: PGA Tour, DP World Tour, LIV Golf and the majors.



## OpenAPI

````yaml /api-reference/openapi.json get /outrights
openapi: 3.0.0
info:
  description: >-
    Odds-API.io is a powerful sports betting odds comparison API, providing
    real-time data from 450+ bookmakers across 34 sports with near zero latency.


    - 450+ bookmakers supported

    - 34 sports including Football, Basketball, Tennis, Esports and more

    - Real-time odds with close to zero latency

    - Pre-match & In-play odds coverage

    - 99.9% uptime for reliability
  title: Odds-API.io - Real-Time Sports Betting Odds API (v3)
  contact: {}
  version: 3.0.0
servers:
  - url: https://api.odds-api.io/v3
security: []
paths:
  /outrights:
    get:
      tags:
        - Outrights
      summary: List Outrights
      description: >-
        Lists outright (futures) tournaments for a sport, sorted by start date.
        bookmakerCount is how many bookmakers you can request in /outrights/odds
        currently price each one, counting any bookmaker with a current price
        for at least one golfer. Golf is the first sport. The default list
        covers the whole season, so later tournaments show bookmakerCount 0
        until bookmakers price them; filter by league to narrow it. Part of the
        Outrights add-on on paid plans.
      parameters:
        - description: API key for authentication
          name: apiKey
          in: query
          required: true
          schema:
            type: string
        - example: golf
          description: Sport name or slug
          name: sport
          in: query
          required: true
          schema:
            type: string
        - example: pga-tour
          description: 'League slug: pga-tour, dp-world-tour, liv-golf or majors'
          name: league
          in: query
          schema:
            type: string
        - example: pending,live
          description: >-
            Comma-separated statuses: pending, live, settled, cancelled.
            Default: pending,live
          name: status
          in: query
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/dto.OutrightDto'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '403':
          description: Outrights add-on required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    dto.OutrightDto:
      type: object
      properties:
        id:
          type: integer
          format: int64
          example: 1001
        name:
          type: string
          example: World Wide Technology Championship 2026
        date:
          type: string
          format: date-time
          description: Scheduled start of the first round
        status:
          type: string
          enum:
            - pending
            - live
            - settled
            - cancelled
        sport:
          $ref: '#/components/schemas/dto.Sport'
        league:
          $ref: '#/components/schemas/dto.League'
        bookmakerCount:
          type: integer
          description: >-
            How many bookmakers you can request in /outrights/odds currently
            price this outright: any bookmaker with a current price for at least
            one golfer counts.
          example: 40
    controllers.ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Error message
    dto.Sport:
      type: object
      properties:
        name:
          type: string
        slug:
          type: string
    dto.League:
      type: object
      properties:
        name:
          type: string
        slug:
          type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.