---
title: "Search for a player by gamertag"
method: GET
path: "/v2/friends/search"
tags: ["friends"]
---

# Search for a player by gamertag

`GET /v2/friends/search`

Look up a player's profile by their gamertag. Returns profile settings including gamertag, gamerscore, avatar, bio, and more.

## Query parameters

- `gt` string

## Response `200`

Player profile information

- 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

- `400` — Missing gamertag parameter
- `401` — Invalid or missing API key
- `404` — Resource not found
- `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)