---
title: "Changes to Search players for the Expo app"
method: GET
path: "/v2/player/search"
---

# Changes to Search players for the Expo app

`GET /v2/player/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-09-09** `9ec0debedfc6`: 7 breaking, 19 info

## Changes

- **2026-09-09** `9ec0debedfc6`: 7 breaking, 19 info
  - for the `query` request parameter `limit`, default value `25` was removed
  - `query` request parameter `limit` list-of-types was narrowed by removing types `integer`
  - response property `items/items/clan/clanLevel` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `items/items/leagueTier/id` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `items/items/townHallLevel` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `pagination/limit` list-of-types was widened by adding types `number and string` to media type `application/json` of response `200`
  - response property `pagination/nextCursor` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - api operation id `searchExpoPlayers` was added
  - for the `query` request parameter `query`, the minLength was decreased from `2` to `0`
  - for the `query` request parameter `clanTags`, the type was generalized from `array` to `string`
  - for the `query` request parameter `leagueIds`, the type was generalized from `array` to `string`
  - for the `query` request parameter `limit`, the type was generalized from `integer` to no type
  - for the `query` request parameter `townhallLevels`, the type was generalized from `array` to `string`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `503`
  - the response property `items` became required for the status `200`
  - the response property `items/items/clan/tag` became required for the status `200`
  - the response property `items/items/leagueTier/id` became required for the status `200`
  - the response property `items/items/leagueTier/name` became required for the status `200`
  - the response property `items/items/name` became required for the status `200`
  - the response property `items/items/tag` became required for the status `200`
  - the response property `items/items/townHallLevel` became required for the status `200`
  - the response property `pagination` became required for the status `200`
  - the response property `pagination/hasMore` became required for the status `200`
  - the response property `pagination/limit` became required for the status `200`
  - the response property `pagination/nextCursor` became required for the status `200`

---

[Operation](https://skmtc.dev/clashk/apis/clashking-api/docs/v2/player/search/get.md) - [API](https://skmtc.dev/clashk/apis/clashking-api.md) - [Page](https://skmtc.dev/clashk/apis/clashking-api/changes/v2/player/search/get)