Skip to Content
API ReferenceLeagues

Leagues

Get a list of available leagues with optional sport filtering.

GET /api/v1/leagues

Requires an API key. Available on all tiers (Free included). Unauthenticated requests return 401.

Query Parameters

ParameterTypeDefaultDescription
sportstringallFilter by sport (e.g., basketball, football)

Example Requests

# List all leagues
curl -X GET "https://api.sharpapi.io/api/v1/leagues" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Filter by sport
curl -X GET "https://api.sharpapi.io/api/v1/leagues?sport=basketball" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success (200)

{
  "data": [
    {
      "id": "nba",
      "name": "NBA",
      "sport": "basketball",
      "event_count": 15,
      "live_count": 2
    },
    {
      "id": "ncaab",
      "name": "NCAAB",
      "sport": "basketball",
      "event_count": 27,
      "live_count": 1
    },
    {
      "id": "wnba",
      "name": "WNBA",
      "sport": "basketball",
      "event_count": 0,
      "live_count": 0
    }
  ],
  "meta": {
    "count": 3,
    "total": 3,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "updated_at": "2026-01-26T12:00:00Z",
    "filters": {
      "sport": "basketball"
    }
  }
}

All Leagues (No Filter)

{
  "data": [
    {
      "id": "nba",
      "name": "NBA",
      "sport": "basketball",
      "event_count": 15,
      "live_count": 2
    },
    {
      "id": "ncaab",
      "name": "NCAAB",
      "sport": "basketball",
      "event_count": 27,
      "live_count": 1
    },
    {
      "id": "wnba",
      "name": "WNBA",
      "sport": "basketball",
      "event_count": 0,
      "live_count": 0
    },
    {
      "id": "nfl",
      "name": "NFL",
      "sport": "football",
      "event_count": 16,
      "live_count": 1
    },
    {
      "id": "ncaaf",
      "name": "NCAAF",
      "sport": "football",
      "event_count": 12,
      "live_count": 0
    },
    {
      "id": "nhl",
      "name": "NHL",
      "sport": "hockey",
      "event_count": 15,
      "live_count": 2
    },
    {
      "id": "mlb",
      "name": "MLB",
      "sport": "baseball",
      "event_count": 0,
      "live_count": 0
    },
    {
      "id": "epl",
      "name": "English Premier League",
      "sport": "soccer",
      "event_count": 10,
      "live_count": 2
    },
    {
      "id": "la_liga",
      "name": "La Liga",
      "sport": "soccer",
      "event_count": 10,
      "live_count": 1
    },
    {
      "id": "serie_a",
      "name": "Serie A",
      "sport": "soccer",
      "event_count": 10,
      "live_count": 1
    },
    {
      "id": "bundesliga",
      "name": "Bundesliga",
      "sport": "soccer",
      "event_count": 5,
      "live_count": 0
    },
    {
      "id": "mls",
      "name": "MLS",
      "sport": "soccer",
      "event_count": 0,
      "live_count": 0
    },
    {
      "id": "atp",
      "name": "ATP",
      "sport": "tennis",
      "event_count": 12,
      "live_count": 4
    },
    {
      "id": "wta",
      "name": "WTA",
      "sport": "tennis",
      "event_count": 6,
      "live_count": 2
    },
    {
      "id": "ufc",
      "name": "UFC",
      "sport": "mma",
      "event_count": 12,
      "live_count": 0
    },
    {
      "id": "pga",
      "name": "PGA Tour",
      "sport": "golf",
      "event_count": 4,
      "live_count": 1
    }
  ],
  "meta": {
    "count": 16,
    "total": 16,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "updated_at": "2026-01-26T12:00:00Z",
    "filters": {}
  }
}

League Object Schema

FieldTypeDescription
idstringLeague identifier (lowercase, use in API filters)
namestringHuman-readable league name
sportstringParent sport ID
event_countintegerTotal events currently available with odds
live_countintegerEvents currently live/in-play

Common Leagues

The endpoint is the canonical source of truth — call GET /api/v1/leagues for the complete, up-to-date list. The atlas registry catalogs 600+ leagues across 30+ sports including UEFA continental competitions, multiple basketball circuits per country, and full tennis/golf/MMA/esports/cricket coverage. The illustrative subset below shows the highest-volume entries you’ll typically filter on:

SportCommon league IDs
Basketballnba, ncaab, wnba
Footballnfl, ncaaf
Hockeynhl
Baseballmlb
Soccerengland_-_premier_league, spain_-_la_liga, italy_-_serie_a, germany_-_bundesliga, france_-_ligue_1, uefa_-_champions_league, usa_-_major_league_soccer
Tennisatp, wta, atp_challenger, itf_men, itf_women
MMAufc, pfl
Golfpga, liv, dp_world_tour, lpga
  • League IDs use canonical slug form (england_-_premier_league, not epl). Some short forms are accepted as filter input for backward compatibility, but the canonical slug is what /leagues returns and what other endpoints emit on response payloads.
  • The event_count and live_count values are dynamic. Off-season leagues (e.g., MLB in winter, WNBA in fall) show 0 events but stay in the catalog.
  • For programmatic access (e.g. building dropdown filters), call /api/v1/leagues and use the response — never hard-code a list.

Using Leagues in Filters

Use the league id as a filter parameter on other endpoints:

# Get NBA odds
curl "https://api.sharpapi.io/api/v1/odds?league=nba" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Get best odds for NFL and NBA
curl "https://api.sharpapi.io/api/v1/odds/best?league=nfl,nba" \
  -H "X-API-Key: YOUR_API_KEY"
Last updated on
SportsSportsbooks