---
title: "Search for players by gamertag"
method: GET
path: "/v2/search/{gamertag}"
tags: ["account"]
---

# Search for players by gamertag

`GET /v2/search/{gamertag}`

Searches for players by gamertag (fuzzy match). Returns up to 15 results.

## Path parameters

- `gamertag` string, required

## Response `200`

Search results

- ApiResponse — Standard API response wrapper. All endpoints return responses in this format.
  - `content` unknown, required
  - `code` integer, required — HTTP status code from the upstream API. Common values: 200 (success), 400 (bad request), 401 (unauthorized), 404 (not found), 410 (deprecated/gone), 429 (rate limited), 500 (server error)

## Other responses

- `401` — Invalid or missing API key
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/xbl/apis/openxbl-api.md) · [All operations](https://skmtc.dev/xbl/apis/openxbl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xbl/openxbl-api/revisions/e5df7bdca559/schema)