GET
/
v0
/
gamertag
/
user-id
/
{id}
curl --request GET \
  --url https://api.zebedee.io/v0/gamertag/user-id/{id} \
  --header 'apikey: <apikey>'
{
  "success": true,
  "data": {
    "gamertag": "speedrunner42"
  },
  "message": "Fetched gamertag from uuid"
}

Get the current ZBD Gamertag for a user when you have their permanent User ID. Useful for displaying current usernames and sending rewards to users you’re tracking by ID.

​
When to Use This

Display Current Names

Show up-to-date gamertags in leaderboards and profiles

Send Rewards by ID

Reward users you track by permanent ID

Sync Databases

Update stored gamertags periodically

User Lookups

Find users in your system by their ID

​
Configuration

​
Path Parameters

​
id
string
required

The permanent User ID (UUID format)

Example: "0a59bf56-daa3-4888-8330-cbc02eba3a6e"

​
Header Parameters

​
apikey
string
required

Your ZBD Project API Key

​
Response

{
  "success": true,
  "data": {
    "gamertag": "speedrunner42"
  },
  "message": "Fetched gamertag from uuid"
}

​
Response Fields

FieldTypeDescription
gamertagstringUser’s current gamertag

Two-Way Mapping - Use Get UserID by Gamertag to go from gamertag → ID, and this endpoint for ID → gamertag. Together they handle all user lookups.