---
title: "Get rank card data"
method: GET
path: "/api/v3/users/{user_id}/rank-card"
tags: ["Rank Card"]
---

# Get rank card data

`GET /api/v3/users/{user_id}/rank-card`

Return full rank card payload including rank, avatar, badges, map totals, and XP.

## Path parameters

- `user_id` integer, required

## Query parameters

- `filter` 'official_playable' | 'official_all' | 'unofficial_playable' | 'unofficial_all' — Filter preset for which maps to include in stats.

## Response `200`

Request fulfilled, document follows

- RankCardResponse
  - `rank_name` string, required
  - `nickname` string, required
  - `background` string, required
  - `total_maps_created` integer, required
  - `total_playtests` integer, required
  - `world_records` integer, required
  - `difficulties` object, required
  - `avatar_skin` string, required
  - `avatar_pose` string, required
  - `badges` RankCardBadgeSettings, required
    - `badge_name1` string, nullable
    - `badge_type1` string, nullable
    - `badge_name2` string, nullable
    - `badge_type2` string, nullable
    - `badge_name3` string, nullable
    - `badge_type3` string, nullable
    - `badge_name4` string, nullable
    - `badge_type4` string, nullable
    - `badge_name5` string, nullable
    - `badge_type5` string, nullable
    - `badge_name6` string, nullable
    - `badge_type6` string, nullable
    - `badge_url1` string, nullable
    - `badge_url2` string, nullable
    - `badge_url3` string, nullable
    - `badge_url4` string, nullable
    - `badge_url5` string, nullable
    - `badge_url6` string, nullable
  - `xp` integer, required
  - `community_rank` string, required
  - `prestige_level` integer, required
  - `skill_score` number, required
  - `skill_tier` integer, required
  - `skill_percentile` number, required
  - `skill_tier_name` string, required
  - `background_url` string
  - `rank_url` string
  - `avatar_url` string

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.net/genji/apis/genji-shimada-api.md) · [All operations](https://skmtc.net/genji/apis/genji-shimada-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genji/genji-shimada-api/revisions/6db12055b305/schema)