---
title: "List a player's characters"
method: GET
path: "/player/{username}/characters"
tags: ["player"]
---

# List a player's characters

`GET /player/{username}/characters`

<Note>
This endpoint is cached for <Badge intent="success" minimal>2 minutes</Badge> in the <Badge intent="warning" minimal>USER</Badge> cache source.   See [Caching](/welcome#caching). <Indent></Indent> This endpoint belongs to the <Badge intent="warning" minimal>PLAYER</Badge> rate-limit bucket. See [Throttling and Rate Limits](/welcome#throttling-and-rate-limits).
</Note>

<Warning>
This response can be restricted by player [Access Rules](/privacy).
</Warning>
<Info>
It is recommended to request players by UUID. Username lookups can return `300 MultipleObjectsReturned` with a multi-selector response when more than one player matches the query.
</Info>

Returns the player's characters keyed by character UUID.

## Path parameters

- `username` string, required

## Response `200`

Character map keyed by character UUID.

- object

## Other responses

- `400` — The player has no characters.
- `403` — Character list visibility is restricted.
- `404` — No matching player was found.
- `500` — Player payload construction failed.

---

[API](https://skmtc.dev/wynncraft/apis/modules.md) · [All operations](https://skmtc.dev/wynncraft/apis/modules/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wynncraft/modules/revisions/6c6214729eae/schema)