---
title: "Get a player"
method: GET
path: "/players/{player_id_or_slug}"
tags: ["Players"]
---

# Get a player

`GET /players/{player_id_or_slug}`

## Request

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

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

## Path parameters

- `player_id_or_slug` union, required: A player ID or slug
  - integer: ID of the player
  - string: Unique, human-readable identifier for the player. `id` and `slug` can be used interchangeably throughout the API.

## Response `200`

A player

- Player
  - `active` boolean, required: Whether player is active
  - `age` number, nullable: Age of the player, `null` if unknown. When `birthday` is `null`, `age` is an approxiamation. Read more about [players' age](/docs/about-players-age) **Note**: This field is only present for users running the Historical plan or above.
  - `birthday` string, nullable: Birth day of the player, `YYYY-MM-DD` format. `null` if unknown. **Note**: This field is only present for users running the Historical plan or above.
  - `current_team` object, nullable, required
    - `acronym` string, nullable, required
    - `dark_mode_image_url` string, uri, nullable, required: URL of the team logo
    - `id` integer, required: The ID of the team.
    - `image_url` string, uri, nullable, required: URL of the team logo
    - `location` string, nullable, required: The team's organization location
    - `modified_at` string, date-time, required
    - `name` string, required: The name of the team.
    - `slug` string, nullable, required
  - `current_videogame` [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object], nullable, required
  - `first_name` string, nullable, required: First name of the player. `null` if unknown
  - `id` integer, required: ID of the player
  - `image_url` string, uri, nullable, required: URL to the photo of the player. `null` if not available.
  - `last_name` string, nullable, required: Last name of the player. `null` if unknown
  - `modified_at` string, date-time, required
  - `name` string, required: Professional name of the player
  - `nationality` string, nullable, required: Country code matching the nationality of the player according to the ISO 3166-1 standard (Alpha-2 code). In addition to the standard, the `XK` code is used for Kosovo. `null` if unknown
  - `role` string, nullable, required: Role/position of the player. Field value varies depending on the video game.`null` if unknown. **Note**: role is only available for DotA 2, League of Legends, and Overwatch players. `null` for other video games.
  - `slug` string, nullable, required: Unique, human-readable identifier for the player. `id` and `slug` can be used interchangeably throughout the API.

## 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)