---
title: "List heroes"
method: GET
path: "/ow/heroes"
tags: ["OW heroes"]
---

# List heroes

`GET /ow/heroes`

## Request

- Base URL: `https://api.pandascore.co`
- URL: `https://api.pandascore.co/ow/heroes`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `token`

List heroes
> ℹ️  
> 
> This endpoint is available to all customers

## Query parameters

- `filter` FilterOverOwHeroes
  - `difficulty` integer[]
  - `id` integer[]
  - `name` string[]
  - `real_name` string[]
  - `role` string[]
  - `slug` string[]
- `range` RangeOverOwHeroes
  - `difficulty` integer[]
  - `id` integer[]
  - `name` string[]
  - `real_name` string[]
  - `role` string[]
  - `slug` string[]
- `sort` string[]
- `search` SearchOverOwHeroes
  - `name` string
  - `real_name` string
  - `role` 'damage' | 'defense' | 'offense' | 'support' | 'tank'
  - `slug` string
- `page` union
  - integer
  - object
    - `number` integer
    - `size` integer
- `per_page` integer

## Response `200`

A list of Overwatch heroes

- object[]
  - `difficulty` integer, required
  - `id` integer, required
  - `image_url` string, uri, required
  - `name` string, required
  - `portrait_url` string, uri, required
  - `real_name` string, required
  - `role` 'damage' | 'defense' | 'offense' | 'support' | 'tank', required
  - `slug` string, required

## Other responses

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

---

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