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.