Skip to main content
GET
https://api.zebedee.io
/
v0
/
user-id
/
gamertag
/
{GAMERTAG}
Get ID by ZBD Gamertag
curl --request GET \
  --url https://api.zebedee.io/v0/user-id/gamertag/{GAMERTAG} \
  --header 'apikey: <apikey>'
{
  "success": true,
  "data": {
    "id": "0a59bf56-daa3-4888-8330-cbc02eba3a6e"
  }
}

​
Description

Make use of this endpoint to get a given User’s ID when provided with a ZBD Gamertag.

​
Usage

This is needed because ZBD Gamertags are akin to social media handles, they are swappable. In the scenario where a Developer is using a ZBD Gamertag as the identifier for transaction limits and/or thresholds (for example), a user could simply change their ZBD Gamertag and try to bypass those constraints. Using a truly unique and immutable ID like the User ID will provide Developers with the needed assurances.

​
Configuration

​
Path Parameters

​
GAMERTAG
string
required
ZBD Gamertag

​
Header Parameters

​
apikey
string
required
ZBD Project API Key
{
  "success": true,
  "data": {
    "id": "0a59bf56-daa3-4888-8330-cbc02eba3a6e"
  }
}