Skip to content
GGScore logoGGScore

Player box scores

API key

Get keys in the cabinet

GET /api/v2/player/{player_id} returns the player, then recent_maps: one row per map with kills, deaths, assists, ADR, and rating when that map was ingested. A profile snapshot is included only after ingest has run. The endpoint does not return KAST, clutch counts, or a career leaderboard.

GET/api/v2/player/{player_id}

Get player

Player card for one UUID from games[].players or another player field. Returns the nickname, country, and recent per-map kills, deaths, and assists. profile is the stored career snapshot (rating, K/D, maps played, role scores) when one exists, otherwise null. recent_limit sets how many map rows come back (newest first, default 10, maximum 50).

Authorizations

X-API-Keyheader

Required. API key from the GGScore cabinet. Do not send this key as Authorization: Bearer. Bearer is a cabinet session token.

Parameters

player_idrequiredpath

Player primary key UUID.

recent_limitoptionalquery

Max recent map rows to return (newest first).

Request

curl -sS 'https://ggscore.net/api/v2/player/{player_id}' \
  -H "X-API-Key: YOUR_API_KEY"

Try it

GET https://ggscore.net/api/v2/player/{player_id}

Fill the path parameters to send this request.