GET
/
v0
/
user-id
/
gamertag
/
{GAMERTAG}
Get UserID by Gamertag
curl --request GET \
  --url https://api.zebedee.io/v0/user-id/gamertag/{GAMERTAG} \
  --header 'apikey: <apikey>'
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

​
gamertag
string
required
The ZBD Gamertag to look up (case-insensitive)Examples: "player123", "bitcoingamer", "speedrunner42"

​
Header Parameters

​
apikey
string
required
Your ZBD Project API Key

​
Response Fields

FieldTypeDescription
idstringPermanent 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.