{"components":{"responses":{"Error":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed; `error.code` says why."}},"schemas":{"Envelope":{"properties":{"data":{"description":"The resource, or a list of them."},"meta":{"description":"Paging, totals and when the data was last updated.","type":"object"}},"required":["data","meta"],"type":"object"},"Error":{"properties":{"error":{"properties":{"code":{"enum":["invalid_request","missing_api_key","invalid_api_key","revoked_api_key","expired_api_key","scope_not_granted","not_found","method_not_allowed","lookup_queued","cursor_expired","rate_limited","quota_exceeded","unavailable","internal_error"],"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"}},"required":["error"],"type":"object"}},"securitySchemes":{"apiKey":{"description":"Send the key as `Authorization: Bearer <key>`. The `X-API-Key` header is accepted too.","scheme":"bearer","type":"http"}}},"info":{"contact":{"email":"api@csxp.gg","url":"https://csxp.gg/api"},"description":"Counter-Strike 2 XP, service medal and collectible data from csxp.gg. Access is paid and keys are issued on request: email api@csxp.gg, message @csxp_gg on Twitter or snek239 on Discord. SteamID64s are strings and times are Unix seconds.","title":"csxp.gg API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/activity":{"get":{"description":"The week's biggest XP gains, leaderboard climbs, newly seen rare collectibles, 2026 service medal tier-ups and XP Overload streaks gained and lost, as shown on csxp.gg/activity.","operationId":"activity","parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"data":{"rank_climbs":[{"board":"overall","climbs":[{"from_rank":412,"passed":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","name":"Sable","steamid64":"76561197960265738","url":"https://csxp.gg/players/76561197960265738"},"places":7,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","name":"Juniper","steamid64":"76561197960265731","url":"https://csxp.gg/players/76561197960265731"},"to_rank":405}],"since":1793729723,"title":"CS2 XP Leaderboard"}],"rare_collectibles":[{"collectible":{"category":"pickem_coin","holders":4,"id":5312,"image_url":"https://csxp.gg/images/cologne2026_coin_bronze_small_png.png","name":"Cologne 2026 Coin","section":"Cologne 2026","share_percent":0.000684,"slug":"cologne2026_coin_bronze","url":"https://csxp.gg/collectibles/cologne2026_coin_bronze"},"first_seen_at":1794301122,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","name":"Marlow","steamid64":"76561197960435530","url":"https://csxp.gg/players/76561197960435530"}}],"service_medal_2026_tiers":[{"at":1794412877,"from_tier":1,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","name":"Kestrel","steamid64":"76561197960287930","url":"https://csxp.gg/players/76561197960287930"},"to_tier":2}],"xp_gains":{"day":[{"from_at":1794383991,"from_total_level":1428,"from_total_xp":7141204,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","name":"Kestrel","steamid64":"76561197960287930","url":"https://csxp.gg/players/76561197960287930"},"to_at":1794466310,"to_total_level":1429,"to_total_xp":7147016,"xp_gained":5812}],"week":[{"from_at":1793866102,"from_total_level":1421,"from_total_xp":7108650,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","name":"Kestrel","steamid64":"76561197960287930","url":"https://csxp.gg/players/76561197960287930"},"to_at":1794466310,"to_total_level":1429,"to_total_xp":7147016,"xp_gained":38366}]},"xp_overload":{"gained":[{"at":1794362400,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","name":"Marlow","steamid64":"76561197960435530","url":"https://csxp.gg/players/76561197960435530"},"weeks":4}],"lost":[{"at":1794362400,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","name":"Sable","steamid64":"76561197960265738","url":"https://csxp.gg/players/76561197960265738"},"weeks":11}]}},"meta":{"players_measured":90606,"tracked_accounts":584626,"updated_at":1794470201,"url":"https://csxp.gg/activity"}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Recent activity","tags":["site"]}},"/api/v1/collectibles":{"get":{"description":"The whole catalogue: every medal, coin, pin and trophy with its holder count, share of tracked accounts and rarity rank. Collectibles nobody tracked holds have no rank.","operationId":"collectibles","parameters":[{"description":"One of service_medal, premier_medal, pickem_coin, operation_coin, major_trophy, pin, genuine_pin, map_coin or badge.","in":"query","name":"category","required":false,"schema":{"type":"string"}},{"description":"`catalog` (default, in-game order) or `rarity` (rarest first).","in":"query","name":"sort","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"category":"genuine_pin","holders":515,"id":6002,"image_url":"https://csxp.gg/images/collectible_pin_guardianelite_small_png.png","name":"Genuine Guardian Elite Pin","rarity_rank":229,"section":null,"share_percent":0.088091,"slug":"genuine-guardian-elite-pin","url":"https://csxp.gg/collectibles/genuine-guardian-elite-pin"},{"category":"genuine_pin","holders":527,"id":6001,"image_url":"https://csxp.gg/images/collectible_pin_dust2_small_png.png","name":"Genuine Dust II Pin","rarity_rank":231,"section":null,"share_percent":0.090143,"slug":"genuine-dust-ii-pin","url":"https://csxp.gg/collectibles/genuine-dust-ii-pin"}],"meta":{"count":34,"tracked_accounts":584626,"updated_at":1794470201}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Collectibles","tags":["collectibles"]}},"/api/v1/collectibles/{slug}":{"get":{"description":"One collectible: its description, when it could be earned, its other tiers or variants, related items from the same event, and this week's newest holders.","operationId":"collectible","parameters":[{"description":"The collectible's slug, as listed by /api/v1/collectibles.","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"awarded_from":"2026-01-01","awarded_until":"2026-12-31","category":"service_medal","description":["Awarded for outstanding service and achievement in 2026."],"has_leaderboard":true,"holders":63,"id":5271,"image_url":"https://csxp.gg/images/service_medal_2026_lvl2_small_png.png","name":"2026 Service Medal Tier 2","ranked_collectibles":534,"rarity_rank":210,"recent_holders":[],"related":[],"section":"2026","share_percent":0.010776,"short_label":"Tier 2","siblings":[{"category":"service_medal","holders":23462,"id":5270,"image_url":"https://csxp.gg/images/service_medal_2026_lvl1_small_png.png","name":"2026 Service Medal Tier 1","section":"2026","share_percent":4.013164,"slug":"service_medal_2026_lvl1","url":"https://csxp.gg/collectibles/service_medal_2026_lvl1"},{"category":"service_medal","holders":9,"id":5272,"image_url":"https://csxp.gg/images/service_medal_2026_lvl3_small_png.png","name":"2026 Service Medal Tier 3","section":"2026","share_percent":0.001539,"slug":"service_medal_2026_lvl3","url":"https://csxp.gg/collectibles/service_medal_2026_lvl3"}],"slug":"service_medal_2026_lvl2","url":"https://csxp.gg/collectibles/service_medal_2026_lvl2"},"meta":{"tracked_accounts":584626,"updated_at":1794470201}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Collectible","tags":["collectibles"]}},"/api/v1/collectibles/{slug}/changes":{"get":{"description":"The accounts that gained or lost a collectible in a date range, oldest first, 50 per page, with the totals for the range in `meta.summary`. `kind` is `first_seen` when the account already held it at its first observation, and otherwise `gained`, `lost`, `banned` or `restored`. Pass `meta.next_cursor` as `cursor` for the next page.","operationId":"collectible_changes","parameters":[{"description":"The collectible's slug, as listed by /api/v1/collectibles.","in":"path","name":"slug","required":true,"schema":{"type":"string"}},{"description":"First UTC day, as YYYY-MM-DD. Default 30 days before `to`.","in":"query","name":"from","required":false,"schema":{"format":"date","type":"string"}},{"description":"Last UTC day, as YYYY-MM-DD. Default today.","in":"query","name":"to","required":false,"schema":{"format":"date","type":"string"}},{"description":"One of all (default), gained, lost, banned or restored.","in":"query","name":"kind","required":false,"schema":{"type":"string"}},{"description":"Count accounts with a possible Counter-Strike ban as non-holders.","in":"query","name":"exclude_banned","required":false,"schema":{"type":"boolean"}},{"description":"`meta.next_cursor` of the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"at":1793523641,"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_medium.jpg","delta":1,"kind":"gained","name":"Juniper","steamid64":"76561197960265731","url":"https://csxp.gg/players/76561197960265731"},{"at":1793610207,"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_medium.jpg","delta":1,"kind":"first_seen","name":"Sable","steamid64":"76561197960265738","url":"https://csxp.gg/players/76561197960265738"}],"meta":{"collectible":"service_medal_2026_lvl2","count":50,"from":"2026-11-01","next_cursor":"1793995112:76561197960265738","summary":{"banned":0,"gained":57,"lost":0,"net":57,"restored":0},"to":"2026-11-07"}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Collectible holder changes","tags":["collectibles"]}},"/api/v1/collectibles/{slug}/history":{"get":{"description":"The holder count over time. With `meta.resolution` of `daily`, there is one point per UTC day with that day's gains, losses and ban changes; otherwise the points are sampled counts.","operationId":"collectible_history","parameters":[{"description":"The collectible's slug, as listed by /api/v1/collectibles.","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"at":1794095999,"banned":0,"gained":2,"holders":61,"holders_excluding_banned":60,"lost":0,"restored":0},{"at":1794182399,"banned":0,"gained":1,"holders":62,"holders_excluding_banned":61,"lost":0,"restored":0},{"at":1794268799,"banned":1,"gained":1,"holders":63,"holders_excluding_banned":61,"lost":0,"restored":0}],"meta":{"collectible":"service_medal_2026_lvl2","count":120,"resolution":"daily"}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Collectible holder history","tags":["collectibles"]}},"/api/v1/collectibles/{slug}/leaderboard":{"get":{"description":"The top 1,000 holders of a medal, pick'em coin or operation coin by total XP. Other collectibles have no such ranking and return a 404.","operationId":"collectible_leaderboard","parameters":[{"description":"The collectible's slug, as listed by /api/v1/collectibles.","in":"path","name":"slug","required":true,"schema":{"type":"string"}},{"description":"Rows to return, 1 to 1,000. Default 100.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Rows to skip. Default 0.","in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"ban_note":null,"new_entry":false,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"collectible_count":30,"commends":{"friendly":211,"leader":180,"teaching":178,"total":569},"cs_updated_at":1781245373,"level":21,"level_xp":699,"name":"Juniper","steam_updated_at":1815893150,"steamid64":"76561197960265731","total_level":1301,"total_xp":6505699,"url":"https://csxp.gg/players/76561197960265731","xp_overload":{"active_weeks":null,"longest_weeks":2,"match_url":null,"observed_at":null,"source":"xp_estimate"}},"possible_cs_ban":false,"rank":1,"rank_change":null,"site_rank":1,"tier":null,"value":1301},{"ban_note":null,"new_entry":false,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"collectible_count":31,"commends":{"friendly":155,"leader":146,"teaching":152,"total":453},"cs_updated_at":1781243972,"level":11,"level_xp":334,"name":"Sable","steam_updated_at":1815893113,"steamid64":"76561197960265738","total_level":1251,"total_xp":6255334,"url":"https://csxp.gg/players/76561197960265738","xp_overload":{"active_weeks":null,"longest_weeks":2,"match_url":null,"observed_at":null,"source":"xp_estimate"}},"possible_cs_ban":false,"rank":2,"rank_change":null,"site_rank":2,"tier":null,"value":1251}],"meta":{"leaderboard":{"collectible":"service_medal_2026_lvl2","player_count":63,"title":"2026 Service Medal Tier 2 holders by total XP","url":"https://csxp.gg/medals/service_medal_2026_lvl2","value_label":"Total Level"},"limit":2,"next_offset":2,"offset":0,"total":63,"updated_at":1794470201}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Collectible holders by XP","tags":["leaderboards"]}},"/api/v1/compare/{a}/{b}":{"get":{"description":"Both players' summaries and the collectibles they share or hold alone.","operationId":"compare","parameters":[{"description":"The first player's SteamID64.","in":"path","name":"a","required":true,"schema":{"type":"string"}},{"description":"The second player's SteamID64.","in":"path","name":"b","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"collectibles":{"only_first":[{"category":"operation_coin","holders":10896,"id":1013,"image_url":"https://csxp.gg/images/operation_bravo_bronze_small_png.png","name":"Operation Bravo Challenge Coin","section":"Operation Bravo","share_percent":1.863756,"slug":"operation_bravo_bronze","url":"https://csxp.gg/collectibles/operation_bravo_bronze"},{"category":"operation_coin","holders":14842,"id":1024,"image_url":"https://csxp.gg/images/operation_phoenix_bronze_small_png.png","name":"Operation Phoenix Challenge Coin","section":"Operation Phoenix","share_percent":2.538717,"slug":"operation_phoenix_bronze","url":"https://csxp.gg/collectibles/operation_phoenix_bronze"}],"only_second":[{"category":"operation_coin","holders":3019,"id":1014,"image_url":"https://csxp.gg/images/operation_bravo_silver_small_png.png","name":"Silver Operation Bravo Coin","section":"Operation Bravo","share_percent":0.516399,"slug":"operation_bravo_silver","url":"https://csxp.gg/collectibles/operation_bravo_silver"},{"category":"operation_coin","holders":4949,"id":1026,"image_url":"https://csxp.gg/images/operation_phoenix_gold_small_png.png","name":"Gold Operation Phoenix Coin","section":"Operation Phoenix","share_percent":0.846524,"slug":"operation_phoenix_gold","url":"https://csxp.gg/collectibles/operation_phoenix_gold"}],"shared":[{"category":"badge","holders":421108,"id":874,"image_url":"https://csxp.gg/images/5yearcoin_small_png.png","name":"5 Year Veteran Coin","section":null,"share_percent":72.030324,"slug":"5-year-veteran-coin","url":"https://csxp.gg/collectibles/5-year-veteran-coin"},{"category":"badge","holders":155862,"id":969,"image_url":"https://csxp.gg/images/10yearcoin_small_png.png","name":"10 Year Veteran Coin","section":null,"share_percent":26.660121,"slug":"10-year-veteran-coin","url":"https://csxp.gg/collectibles/10-year-veteran-coin"}]},"players":[{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"collectible_count":35,"commends":{"friendly":405,"leader":329,"teaching":333,"total":1067},"cs_updated_at":1769079159,"level":29,"level_xp":2016,"name":"Kestrel","steam_updated_at":1790079997,"steamid64":"76561197960287930","total_level":1429,"total_xp":7147016,"url":"https://csxp.gg/players/76561197960287930","xp_overload":{"active_weeks":null,"longest_weeks":1,"match_url":null,"observed_at":null,"source":"xp_estimate"}},{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"collectible_count":27,"commends":{"friendly":231,"leader":178,"teaching":163,"total":572},"cs_updated_at":1769132289,"level":2,"level_xp":3921,"name":"Marlow","steam_updated_at":1790075012,"steamid64":"76561197960435530","total_level":1362,"total_xp":6813921,"url":"https://csxp.gg/players/76561197960435530","xp_overload":null}],"url":"https://csxp.gg/compare/76561197960287930/76561197960435530"},"meta":{"tracked_accounts":584626}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Compare two players","tags":["players"]}},"/api/v1/feeds/snapshots":{"get":{"description":"Every newly recorded change to a tracked account's level, XP, Commends or collectibles, in the order it was stored, with what changed since the account's previous observation. Call it without `after` to get a starting cursor, then poll with the latest `meta.next_after`; when `meta.caught_up` is true, wait before asking again. Rows appear about 30 seconds after they are recorded. The feed keeps the most recent five million snapshots: an older cursor returns 410 `cursor_expired`.","operationId":"feed_snapshots","parameters":[{"description":"Return snapshots with an id above this cursor. Omit to start at the newest.","in":"query","name":"after","required":false,"schema":{"type":"integer"}},{"description":"Rows to return, 1 to 500. Default 200.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"collectibles":[874,970,5270],"collectibles_added":[5270],"collectibles_removed":[],"commends":{"friendly":41,"leader":38,"teaching":35},"exact_xp":true,"id":412345679,"level":2,"level_xp":312,"previous":{"commends":{"friendly":41,"leader":38,"teaching":35},"exact_xp":true,"last_seen_at":1794381200,"level":40,"recorded_at":1794294800,"total_level":279,"total_xp":1399104},"recorded_at":1794467512,"steamid64":"76561197960265731","total_level":281,"total_xp":1405312,"url":"https://csxp.gg/players/76561197960265731","xp_gained":6208},{"collectibles":[],"collectibles_added":null,"collectibles_removed":null,"commends":{"friendly":0,"leader":0,"teaching":0},"exact_xp":true,"id":412345683,"level":3,"level_xp":1190,"previous":null,"recorded_at":1794467518,"steamid64":"76561197960265738","total_level":3,"total_xp":16190,"url":"https://csxp.gg/players/76561197960265738","xp_gained":null}],"meta":{"caught_up":false,"count":2,"next_after":412345683,"oldest_after":407350112}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Snapshot feed","tags":["feeds"]}},"/api/v1/key":{"get":{"description":"The calling key's endpoint groups, rate limit and this month's usage. Every key can call it, and it counts as a request.","operationId":"key","parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"data":{"created_at":1793491200,"expires_at":null,"name":"Acme Analytics","prefix":"csxp_1a2b3c4d","quota":{"monthly_requests":500000,"remaining":371580,"resets_at":1796083200,"used":128420},"rate_limit":{"requests_per_minute":120},"scopes":["players","leaderboards","collectibles","site","search"]},"meta":{}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Your key","tags":["key"]}},"/api/v1/leaderboards":{"get":{"description":"Every leaderboard with its key, what it ranks by and how many players qualify for it.","operationId":"leaderboards","parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"board":"overall","description":"Sorted by total XP level. Remaining XP breaks ties.","player_count":584626,"title":"CS2 XP Leaderboard","url":"https://csxp.gg/total","value_label":"Level"},{"board":"commendations","description":"Sorted by total commends. Friendly, leader, and teacher counts break ties.","player_count":573494,"title":"Commends Leaderboard","url":"https://csxp.gg/commendations","value_label":"Total Commends"}],"meta":{"count":30,"max_entries":1000}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Leaderboards","tags":["leaderboards"]}},"/api/v1/leaderboards/{board}":{"get":{"description":"The top 1,000 players of a leaderboard. `rank` orders by the board's value alone; `site_rank` is the place on csxp.gg, which lists accounts with a possible Counter-Strike ban after everyone else. `rank_change` is the places gained since about a day earlier (negative when lost).","operationId":"leaderboard","parameters":[{"description":"The leaderboard's key, such as overall or service_medal_2026.","in":"path","name":"board","required":true,"schema":{"type":"string"}},{"description":"Rows to return, 1 to 1,000. Default 100.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Rows to skip. Default 0.","in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"ban_note":null,"new_entry":false,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"collectible_count":35,"commends":{"friendly":405,"leader":329,"teaching":333,"total":1067},"cs_updated_at":1769079159,"level":29,"level_xp":2016,"name":"Kestrel","steam_updated_at":1790079997,"steamid64":"76561197960287930","total_level":1429,"total_xp":7147016,"url":"https://csxp.gg/players/76561197960287930","xp_overload":{"active_weeks":null,"longest_weeks":1,"match_url":null,"observed_at":null,"source":"xp_estimate"}},"possible_cs_ban":false,"rank":1,"rank_change":null,"site_rank":1,"tier":null,"value":1429},{"ban_note":null,"new_entry":false,"player":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"collectible_count":27,"commends":{"friendly":231,"leader":178,"teaching":163,"total":572},"cs_updated_at":1769132289,"level":2,"level_xp":3921,"name":"Marlow","steam_updated_at":1790075012,"steamid64":"76561197960435530","total_level":1362,"total_xp":6813921,"url":"https://csxp.gg/players/76561197960435530","xp_overload":null},"possible_cs_ban":false,"rank":2,"rank_change":null,"site_rank":2,"tier":null,"value":1362}],"meta":{"leaderboard":{"board":"overall","description":"Sorted by total XP level. Remaining XP breaks ties.","player_count":584626,"title":"CS2 XP Leaderboard","url":"https://csxp.gg/total","value_label":"Level"},"limit":2,"next_offset":2,"offset":0,"total":1000,"updated_at":1794470201}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Leaderboard entries","tags":["leaderboards"]}},"/api/v1/players":{"get":{"description":"Summaries of up to 100 players in one request, in the order asked for. Players the site does not track are listed in `meta.not_tracked`.","operationId":"players","parameters":[{"description":"1 to 100 SteamID64s, separated by commas.","in":"query","name":"ids","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"collectible_count":35,"commends":{"friendly":405,"leader":329,"teaching":333,"total":1067},"cs_updated_at":1769079159,"level":29,"level_xp":2016,"name":"Kestrel","steam_updated_at":1790079997,"steamid64":"76561197960287930","total_level":1429,"total_xp":7147016,"url":"https://csxp.gg/players/76561197960287930","xp_overload":{"active_weeks":null,"longest_weeks":1,"match_url":null,"observed_at":null,"source":"xp_estimate"}},{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"collectible_count":27,"commends":{"friendly":231,"leader":178,"teaching":163,"total":572},"cs_updated_at":1769132289,"level":2,"level_xp":3921,"name":"Marlow","steam_updated_at":1790075012,"steamid64":"76561197960435530","total_level":1362,"total_xp":6813921,"url":"https://csxp.gg/players/76561197960435530","xp_overload":null}],"meta":{"count":2,"not_tracked":[]}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Players in bulk","tags":["players"]}},"/api/v1/players/{steamid64}":{"get":{"description":"A player's current level, XP, Commends, bans, 2026 service medal progress, XP Overload streak, leaderboard ranks and share of tracked accounts at or above their XP. `steam` or `cs` is null when that half has not been collected yet. For a player the site does not track, a key with the `lookups` group queues a lookup and the response is a 404 with code `lookup_queued`; retry after a few seconds.","operationId":"player","parameters":[{"description":"The player's SteamID64, such as 76561197960287930.","in":"path","name":"steamid64","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","cs":{"collectible_count":35,"commends":{"friendly":405,"leader":329,"teaching":333,"total":1067},"exact_xp":true,"level":29,"level_xp":2016,"total_level":1429,"total_xp":7147016,"updated_at":1792489959},"lookup_pending":false,"name":"Kestrel","ranks":[{"board":"overall","rank":1,"title":"CS2 XP Leaderboard","url":"https://csxp.gg/total#player-76561197960287930"},{"board":"purple_medals","rank":1,"title":"Purple Medal Leaderboard","url":"https://csxp.gg/medals/purple#player-76561197960287930"},{"board":"blue_medals","rank":307,"title":"Blue Medal Leaderboard","url":"https://csxp.gg/medals/blue#player-76561197960287930"}],"service_medal_2026":{"next_tier":1,"next_tier_xp":200000,"tier":0,"xp":142016},"steam":{"bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"updated_at":1790079997},"steamid64":"76561197960287930","top_percent":0.000171,"url":"https://csxp.gg/players/76561197960287930","xp_overload":{"active_weeks":null,"longest_weeks":1,"match_url":null,"observed_at":null,"source":"xp_estimate"}},"meta":{"tracked_accounts":584626}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Player profile","tags":["players"]}},"/api/v1/players/{steamid64}/collectibles":{"get":{"description":"The medals, coins, pins and trophies the player holds, each with its holder count, and every recorded change to that set.","operationId":"player_collectibles","parameters":[{"description":"The player's SteamID64, such as 76561197960287930.","in":"path","name":"steamid64","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"changes":[{"added":[{"category":"pickem_coin","holders":28707,"id":5211,"image_url":"https://csxp.gg/images/bud2025_coin_silver_small_png.png","name":"Budapest 2025 Silver Coin","section":"Budapest 2025","share_percent":4.910319,"slug":"bud2025_coin_silver","url":"https://csxp.gg/collectibles/bud2025_coin_silver"}],"at":1787763161,"previous_at":1787754283,"removed":[{"category":"pickem_coin","holders":3501,"id":5210,"image_url":"https://csxp.gg/images/bud2025_coin_bronze_small_png.png","name":"Budapest 2025 Coin","section":"Budapest 2025","share_percent":0.598844,"slug":"bud2025_coin_bronze","url":"https://csxp.gg/collectibles/bud2025_coin_bronze"}]},{"added":[{"category":"premier_medal","holders":3348,"id":5150,"image_url":"https://csxp.gg/images/premier_season_3_coin_25_small_png.png","name":"Premier Season Three Medal · 5,000–9,999 · 125+ wins","section":"Season 3 · 5,000–9,999","share_percent":0.572674,"slug":"premier_season_3_coin_25","url":"https://csxp.gg/collectibles/premier_season_3_coin_25"}],"at":1792489959,"previous_at":1790813381,"removed":[]}],"collectibles":[{"category":"badge","holders":421108,"id":874,"image_url":"https://csxp.gg/images/5yearcoin_small_png.png","name":"5 Year Veteran Coin","section":null,"share_percent":72.030324,"slug":"5-year-veteran-coin","url":"https://csxp.gg/collectibles/5-year-veteran-coin"},{"category":"badge","holders":155862,"id":969,"image_url":"https://csxp.gg/images/10yearcoin_small_png.png","name":"10 Year Veteran Coin","section":null,"share_percent":26.660121,"slug":"10-year-veteran-coin","url":"https://csxp.gg/collectibles/10-year-veteran-coin"},{"category":"badge","holders":341624,"id":970,"image_url":"https://csxp.gg/images/prime_badge_small_png.png","name":"Loyalty Badge","section":null,"share_percent":58.434623,"slug":"loyalty-badge","url":"https://csxp.gg/collectibles/loyalty-badge"}],"steamid64":"76561197960287930","updated_at":1792489959},"meta":{"changes_truncated":false,"count":35,"tracked_accounts":584626}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Player collectibles","tags":["players"]}},"/api/v1/players/{steamid64}/profile-history":{"get":{"description":"Every recorded Steam name, avatar and ban state of the player, oldest first.","operationId":"player_profile_history","parameters":[{"description":"The player's SteamID64, such as 76561197960287930.","in":"path","name":"steamid64","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","bans":{"community_banned":false,"days_since_last_ban":null,"economy_ban":null,"game_bans":0,"vac_bans":0},"name":"Kestrel","observed_from":1787746119,"observed_until":1790079997}],"meta":{"count":1,"truncated":false}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Player Steam profile history","tags":["players"]}},"/api/v1/players/{steamid64}/rank-history":{"get":{"description":"The player's rank on each leaderboard at every publication they were ranked in, as `[recorded_at, rank]` pairs, oldest first.","operationId":"player_rank_history","parameters":[{"description":"The player's SteamID64, such as 76561197960287930.","in":"path","name":"steamid64","required":true,"schema":{"type":"string"}},{"description":"Only this leaderboard, by its key from /api/v1/leaderboards.","in":"query","name":"board","required":false,"schema":{"type":"string"}},{"description":"Only rows observed at or after this Unix time.","in":"query","name":"from","required":false,"schema":{"type":"integer"}},{"description":"Only rows observed at or before this Unix time.","in":"query","name":"to","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"board":"overall","current_rank":1,"points":[[1787747328,1],[1787754272,1],[1787763154,1]],"title":"CS2 XP Leaderboard"}],"meta":{"truncated":false}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Player rank history","tags":["players"]}},"/api/v1/players/{steamid64}/xp-history":{"get":{"description":"Every recorded state of the player's level, XP and Commends, oldest first. Each row covers the period from `observed_from` to `observed_until` during which nothing changed. At most the newest 5,000 rows are returned; `meta.truncated` says when older ones were left out.","operationId":"player_xp_history","parameters":[{"description":"The player's SteamID64, such as 76561197960287930.","in":"path","name":"steamid64","required":true,"schema":{"type":"string"}},{"description":"Only rows observed at or after this Unix time.","in":"query","name":"from","required":false,"schema":{"type":"integer"}},{"description":"Only rows observed at or before this Unix time.","in":"query","name":"to","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"collectible_count":34,"commends":{"friendly":400,"leader":324,"teaching":328,"total":1052},"exact_xp":true,"level":9,"level_xp":2326,"observed_from":1787747564,"observed_until":1787747564,"total_level":1409,"total_xp":7047326},{"collectible_count":34,"commends":{"friendly":400,"leader":324,"teaching":328,"total":1052},"exact_xp":true,"level":9,"level_xp":4366,"observed_from":1787754283,"observed_until":1787754283,"total_level":1409,"total_xp":7049366}],"meta":{"count":28,"truncated":false}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Player XP history","tags":["players"]}},"/api/v1/resolve":{"get":{"description":"The SteamID64 behind a vanity name or a Steam profile link.","operationId":"resolve","parameters":[{"description":"A vanity name, a steamcommunity.com profile link or a SteamID64.","in":"query","name":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"resolved_from":"vanity","steamid64":"76561197960287930","url":"https://csxp.gg/players/76561197960287930"},"meta":{}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Resolve a Steam profile","tags":["search"]}},"/api/v1/search/holders":{"get":{"description":"Players holding a set of collectibles, by total XP. Only the first 1,000 can be paged through; `meta.total` counts all of them.","operationId":"search_holders","parameters":[{"description":"Slugs of collectibles to hold, comma-separated or repeated.","in":"query","name":"collectible","required":true,"schema":{"type":"string"}},{"description":"Slugs of collectibles the player must not hold.","in":"query","name":"exclude","required":false,"schema":{"type":"string"}},{"description":"`all` (default) to hold every `collectible`, or `any` for at least one.","in":"query","name":"match","required":false,"schema":{"type":"string"}},{"description":"Page of 20 results, starting at 1.","in":"query","name":"page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","collectible_count":30,"name":"Juniper","steamid64":"76561197960265731","total_level":1301,"total_xp":6505699,"url":"https://csxp.gg/players/76561197960265731"},{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","collectible_count":31,"name":"Sable","steamid64":"76561197960265738","total_level":1251,"total_xp":6255334,"url":"https://csxp.gg/players/76561197960265738"}],"meta":{"max_results":1000,"page":1,"page_size":20,"pages":4,"total":63}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Search players by collectibles","tags":["search"]}},"/api/v1/search/players":{"get":{"description":"Players whose current or past Steam name contains the text, most recently seen first. Very common names return the first matches found with `meta.partial` set and no further pages.","operationId":"search_players","parameters":[{"description":"Part of a Steam name, with at least 3 consecutive letters or digits.","in":"query","name":"name","required":true,"schema":{"type":"string"}},{"description":"Page of 20 results, starting at 1.","in":"query","name":"page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","collectible_count":35,"name":"Kestrel","steamid64":"76561197960287930","total_level":1429,"total_xp":7147016,"url":"https://csxp.gg/players/76561197960287930"},{"avatar_url":"https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg","collectible_count":25,"name":"kestrel_cs","steamid64":"76561197960265731","total_level":746,"total_xp":3731181,"url":"https://csxp.gg/players/76561197960265731"}],"meta":{"page":1,"page_size":20,"pages":2,"partial":false,"query":"kestrel","total":21}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Search players by name","tags":["search"]}},"/api/v1/stats":{"get":{"description":"Totals across tracked accounts and the distributions of levels, Commends, collectibles and 2026 service medal tiers, as shown on csxp.gg/stats.","operationId":"stats","parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"data":{"collectibles_per_account":[{"accounts":516,"collectibles":0},{"accounts":32767,"collectibles":1}],"commends":{"accounts_by_total":[{"accounts":11132,"from":0,"to":0},{"accounts":104066,"from":1,"to":9}],"friendly":{"accounts":567821,"received":39561326},"leader":{"accounts":560555,"received":38094844},"teaching":{"accounts":557181,"received":37791857}},"current_level":[{"accounts":22123,"level":0},{"accounts":22346,"level":1}],"service_medal_2026_tier":[{"accounts":561091,"tier":0},{"accounts":23462,"tier":1}],"total_level":{"accounts_by_level":[{"accounts":0,"from":0,"to":0},{"accounts":0,"from":1,"to":9}],"leveled_accounts":584626,"top_slices":[{"accounts":58605,"top_percent":10.0,"total_level":565},{"accounts":5868,"top_percent":1.0,"total_level":887}]},"totals":{"collectibles_held":5289445,"commends_received":115448027,"levels_earned":121739323,"service_medal_2026_holders":23535,"tracked_accounts":584626}},"meta":{"updated_at":1794470201,"url":"https://csxp.gg/stats"}},"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"The requested data."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"summary":"Site statistics","tags":["site"]}}},"security":[{"apiKey":[]}],"servers":[{"url":"https://csxp.gg"}],"tags":[{"description":"Key","name":"key"},{"description":"Players","name":"players"},{"description":"Leaderboards","name":"leaderboards"},{"description":"Collectibles","name":"collectibles"},{"description":"Site data","name":"site"},{"description":"Search","name":"search"},{"description":"Feeds","name":"feeds"}]}