Leagues Endpoint

Retrieve information about available sports leagues.

GET

/api/v1/nba/odds/leagues

Description

Returns a list of all available sports leagues. Use this endpoint to discover which leagues are supported and get league IDs for filtering other endpoints.

Parameters

Name	Type	Required	Description
`league_id`	integer	Optional	Filter by specific league ID
`sport`	string	Optional	Filter by sport name. Currently only `basketball` (NBA) is supported.
`is_active`	boolean	Optional	Filter by active status

Example Request

curl -X 'GET' \
'http://localhost:5000/api/v1/nba/odds/leagues?league_id=4&sport=basketball&is_active=true' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer sk_your_api_key_here'

Example Response

{
  "success": true,
  "data": [
    {
      "id": 4,
      "sport": "basketball",
      "name": "nba",
      "description": "Men's National Basketball Association",
      "logo": "https://example.com/leagues/nba.png",
      "current_season": "2025",
      "current_season_type": "reg",
      "is_active": true
    },
    {
      "id": 5,
      "sport": "basketball",
      "name": "wnba",
      "description": "Women's National Basketball Association",
      "logo": "https://example.com/leagues/wnba.png",
      "current_season": "2025",
      "current_season_type": "reg",
      "is_active": true
    }
  ],
  "count": 2
}