---
title: "Rivals leaderboard window (self +/- 2) around a character. Defaults to the class leaderboard; pass specId for the spec leaderboard."
method: GET
path: "/api/v1/client/character-rivals"
tags: ["mythic_plus"]
---

# Rivals leaderboard window (self +/- 2) around a character. Defaults to the class leaderboard; pass specId for the spec leaderboard.

`GET /api/v1/client/character-rivals`

## Query parameters

- `access_key` string — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
- `region` 'us' | 'eu' | 'tw' | 'kr' | 'cn', required — Name of region to look up character in. Can be one of: us, eu, kr, tw
- `realm` string, required — Name of realm that character is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"
- `name` string, required — Name of the character to look up. This is not case sensitive.
- `scope` 'realm' | 'region' | 'world' — Scope of the rivals leaderboard. One of: realm, region, world
- `specId` integer — Optional spec ID. When provided, ranks on that spec's leaderboard; otherwise defaults to the character's class leaderboard.

## Response `200`

Successful

- CharacterRivalsResponse
  - `rivals` Rivals, nullable, required — Class (or spec) leaderboard window around the character, or null if unavailable
    - `scope` 'realm' | 'region' | 'world', required — Scope of the rivals leaderboard
    - `entries` CharacterRivalEntry[], required — Leaderboard entries around the character (self +/- 2)
      - `rank` integer, required — Leaderboard rank
      - `name` string, required — Character name
      - `realm` string, required — Character realm name
      - `score` number, required — Leaderboard score
      - `isSelf` boolean, required — Whether this entry is the requested character

---

[API](https://skmtc.net/raider/apis/raider-io-developer-api.md) · [All operations](https://skmtc.net/raider/apis/raider-io-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/raider/raider-io-developer-api/versions/4c612ac925bb/schema)