Skip to main content
GET
List CS2 players

What it returns

Player directory keyed by HLTV id. Filter by current team via team_hltv_id; search runs the same trigram-ranked match used by the unified search endpoint — exact → prefix → substring → fuzzy similarity, scored 0–1. When search is supplied, results come back ordered by relevance score. Without it, the default sort is nickname A→Z.

Required scope

  • Minimum: cs2:players:list

Example

Trigram tolerates typos:
For global autocomplete across all entity types in one call, use GET /cs2/v1/search.

Authorizations

X-API-Key
string
header
required

Tenant API key issued during onboarding

Query Parameters

team_hltv_id
integer | null

Filter by current team's HLTV ID.

search
string | null

Trigram-ranked search on nickname. Exact > prefix > substring > fuzzy similarity. Same ranking the unified /search endpoint uses.

limit
integer
default:100
Required range: 1 <= x <= 500

Response

Successful Response

The response is of type Response List Players Cs2 V1 Players Get · object.

Last modified on May 10, 2026