---
title: "Get a league"
method: GET
path: "/leagues/{league_id_or_slug}"
tags: ["Leagues"]
---

# Get a league

`GET /leagues/{league_id_or_slug}`

## Request

- Base URL: `https://api.pandascore.co`
- URL: `https://api.pandascore.co/leagues/{league_id_or_slug}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `token`

Get a single league by ID or by slug
> ℹ️  
> 
> This endpoint is available to all customers

## Path parameters

- `league_id_or_slug` union, required: A league ID or slug
  - integer
  - string

## Response `200`

A league

- League
  - `id` integer, required
  - `image_url` string, uri, nullable, required
  - `modified_at` string, date-time, required
  - `name` string, required
  - `series` object[], required
    - `begin_at` string, date-time, nullable, required
    - `end_at` string, date-time, nullable, required
    - `full_name` string, required
    - `id` integer, required
    - `league_id` integer, required
    - `modified_at` string, date-time, required
    - `name` string, nullable, required
    - `season` string, nullable, required
    - `slug` string, required
    - `winner_id` union, required
      - integer: ID of the player
      - integer: The ID of the team.
    - `winner_type` 'Player' | 'Team', nullable, required
    - `year` integer, nullable, required
  - `slug` string, required
  - `url` string, uri, nullable, required
  - `videogame` union, required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'LoL', required
      - `slug` 'league-of-legends', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'Counter-Strike', required
      - `slug` 'cs-go', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'Dota 2', required
      - `slug` 'dota-2', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'Overwatch', required
      - `slug` 'ow', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'PUBG', required
      - `slug` 'pubg', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'Rocket League', required
      - `slug` 'rl', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'Call of Duty', required
      - `slug` 'cod-mw', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'Rainbow 6 Siege', required
      - `slug` 'r6-siege', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'EA Sports FC', required
      - `slug` 'fifa', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'Valorant', required
      - `slug` 'valorant', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'King of Glory', required
      - `slug` 'kog', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'LoL Wild Rift', required
      - `slug` 'lol-wild-rift', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'StarCraft 2', required
      - `slug` 'starcraft-2', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'StarCraft Brood War', required
      - `slug` 'starcraft-brood-war', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'Mobile Legends: Bang Bang', required
      - `slug` 'mlbb', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'eBasketball', required
      - `slug` 'e-basketball', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'eCricket', required
      - `slug` 'e-cricket', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'eHockey', required
      - `slug` 'e-hockey', required
    - object
      - `current_version` string, nullable, required
      - `id` unknown, required
      - `name` 'eSoccer', required
      - `slug` 'e-soccer', required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/pandascore/apis/all-videogames.md) - [All operations](https://skmtc.dev/pandascore/apis/all-videogames/llms.txt) - [OpenAPI document](https://skmtc.dev/pandascore/apis/all-videogames/revisions/fbe658ee806a?raw)