---
title: "List visible player locations"
method: GET
path: "/map/locations/player"
tags: ["map"]
---

# List visible player locations

`GET /map/locations/player`

<Note>
This endpoint is cached for <Badge intent="success" minimal>15 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>MAP</Badge> rate-limit bucket. See [Throttling and Rate Limits](/welcome#throttling-and-rate-limits).
</Note>

<Warning>
Try it will not return usable data for this route. It depends on authentication and IP-aware context, so test it against the live API outside the docs.
</Warning>

## Response `200`

Visible player locations.

- PlayerLocation[]
  - `uuid` string, uuid, required
  - `name` string, required
  - `nickname` string, nullable, required
  - `character` string, uuid, required
  - `server` string, nullable, required
  - `x` integer, required
  - `y` integer, required
  - `z` integer, required
  - `friends` PlayerLocationMember[], required
    - `uuid` string, uuid, required
    - `name` string, required
    - `nickname` string, nullable, required
    - `character` string, uuid, required
    - `server` string, nullable, required
    - `x` integer, required
    - `y` integer, required
    - `z` integer, required
  - `party` PlayerLocationMember[], required
    - `uuid` string, uuid, required
    - `name` string, required
    - `nickname` string, nullable, required
    - `character` string, uuid, required
    - `server` string, nullable, required
    - `x` integer, required
    - `y` integer, required
    - `z` integer, required
  - `guild` PlayerLocationMember[], required
    - `uuid` string, uuid, required
    - `name` string, required
    - `nickname` string, nullable, required
    - `character` string, uuid, required
    - `server` string, nullable, required
    - `x` integer, required
    - `y` integer, required
    - `z` integer, required

## Other responses

- `403` — No eligible online player location could be resolved.

---

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