Overview
Get UserID by Gamertag
Convert a ZBD Gamertag to a permanent User ID for reliable tracking
GET
Get UserID by Gamertag
Get a user’s permanent ID from their ZBD Gamertag. Essential for tracking users reliably since gamertags can change but User IDs never do.
Critical for User Tracking - Gamertags are like Twitter handles - users can change them anytime. Always use the permanent User ID for databases, limits, and historical tracking.
Why This Matters
Prevent Abuse
Users can’t bypass limits by changing gamertags
Accurate Analytics
Track the same user even after name changes
Configuration
Path Parameters
The ZBD Gamertag to look up (case-insensitive)
Examples: "player123"
, "bitcoingamer"
, "speedrunner42"
Header Parameters
Your ZBD Project API Key
Response Fields
Field | Type | Description |
---|---|---|
id | string | Permanent User ID (UUID format) |
Pro Tip: Always store both the User ID (permanent) and current gamertag (for display). This gives you reliability and good UX.
Get UserID by Gamertag