---
title: "Get a public roster snapshot"
method: GET
path: "/v2/public/rosters/{publicShareId}"
tags: ["Public Rosters"]
---

# Get a public roster snapshot

`GET /v2/public/rosters/{publicShareId}`

## Request

- Base URL: `https://api.clashk.ing`
- URL: `https://api.clashk.ing/v2/public/rosters/{publicShareId}`
- Auth: none required

## Path parameters

- `publicShareId` string, required

## Response `200`

Success

- object
  - `id` string, required
  - `name` string, required
  - `minTownhall` union
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'
  - `maxTownhall` union
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'
  - `description` string
  - `clanName` string
  - `clanTag` string
  - `clanBadgeUrl` string
  - `updatedAt` string, required
  - `members` object[], required
    - `playerTag` string, required
    - `name` string, required
    - `townhall` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `refreshedAt` string, nullable, required
    - `currentClanName` string
    - `currentClanTag` string

## Changes

- **2026-09-09** `9ec0debedfc6`: 1 breaking, 12 info
  - response property `members/items/townhall` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - api operation id `dashboardPublicRoster` was added
  - removed the non-success response with the status `404`
  - added the optional property `maxTownhall` to the response with the `200` status
  - …9 more

[Operation history](https://skmtc.dev/clashk/apis/clashking-api/changes/v2/public/rosters/:publicShareId/get.md)

---

[API](https://skmtc.dev/clashk/apis/clashking-api.md) - [All operations](https://skmtc.dev/clashk/apis/clashking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clashk/apis/clashking-api/revisions/8411b4ef8009?raw)