---
title: "List online players"
method: GET
path: "/player"
tags: ["player"]
---

# List online players

`GET /player`

<Note>
This endpoint is cached for <Badge intent="success" minimal>30 seconds</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>
Online player list is subject to [Access Rules](/privacy), which can hide some players from the list. Rely on the field `total` to have the accurate player count.
</Warning>

## Query parameters

- `identifier` 'username' | 'uuid'
- `server` union
  - string
  - integer

## Response `200`

Online player summary.

- OnlinePlayerList
  - `total` integer, required
  - `players` OnlinePlayerListPlayers, required
    - `identifier` string, server

---

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