---
title: "Returns the league index for a sport at one book: each league key with its name and market count, for use as the league parameter on the markets endpoint."
method: GET
path: "/api/v2/{book}/{sport}/leagues"
tags: ["Source API (v2)"]
---

# Returns the league index for a sport at one book: each league key with its name and market count, for use as the league parameter on the markets endpoint.

`GET /api/v2/{book}/{sport}/leagues`

## Request

- Base URL: `https://api.owlsinsight.com`
- URL: `https://api.owlsinsight.com/api/v2/{book}/{sport}/leagues`
- Auth: HTTP bearer

Returns the league index for a sport at one book: each league key with its name and market count, for use as the league parameter on the markets endpoint.

Single-league sports still answer, with one entry.

marketCount counts the entries a request without marketIds returns. Books that leave some entries out by default (DraftKings US sports: props-*) also give marketCountExcludedByDefault, the entries reachable only with marketIds.

The SDKs expose one method per book: get<Book>V2Leagues in TypeScript and get_<book>_v2_leagues in Python.

## Path parameters

- `book` string, required
- `sport` string, required

## Response `200`

OK

- V2LeaguesResponse
  - `leagueCount` number, double
  - `leagues` V2LeagueIndexEntry[]
    - `leagueKey` string
    - `leagueName` string
    - `marketCount` number, double
    - `updatedAt` number, double
  - `meta` V2Meta
    - `ageSeconds` number, double
    - `cacheTimestamp` string
    - `cached` boolean
    - `duplicateMarketIdsDropped` number, double
    - `leagueCount` number, double
    - `leaguesOmitted` number, double
    - `marketsOmitted` number, double
    - `merged` boolean
    - `source` string
    - `status` string
    - `timestamp` string
    - `truncated` boolean
  - `sport` string
  - `success` boolean

---

[API](https://skmtc.dev/owlsinsight/apis/owls-insight-api.md) · [All operations](https://skmtc.dev/owlsinsight/apis/owls-insight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/owlsinsight/apis/owls-insight-api/revisions/76c1ea016ff1?raw)