---
title: "Get the town hall leaderboard"
method: GET
path: "/v2/leaderboard/townhalls/{townhallLevel}"
tags: ["Leaderboard"]
---

# Get the town hall leaderboard

`GET /v2/leaderboard/townhalls/{townhallLevel}`

## Request

- Base URL: `https://api.clashk.ing`
- URL: `https://api.clashk.ing/v2/leaderboard/townhalls/{townhallLevel}`
- Auth: none required

## Path parameters

- `townhallLevel` union, required
  - number
  - 'NaN'
  - 'Infinity'
  - '-Infinity'

## Query parameters

- `limit` union
  - number
  - 'NaN'
  - 'Infinity'
  - '-Infinity'

## Response `200`

Success

- object
  - `league_tier_id` union
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'
  - `townhall_level` union
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'
  - `items` object[], required
    - `rank` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `tag` string, required
    - `name` string, required
    - `leagueGroupId` string, required
    - `league_id` union
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `league` object
      - `id` union, required
        - number
        - 'NaN'
        - 'Infinity'
        - '-Infinity'
      - `name` string, required
      - `badge` string, required
    - `clan_tag` string
    - `clan` object
      - `tag` string, required
      - `name` string
      - `badge` string, required
    - `townhall_level` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `trophies` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
    - `country_code` string
    - `country_name` string
  - `count` union, required
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'
  - `generated_at` string

---

[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/682a1619590d?raw)