Skip to main content
GET
/
player
/
{membershipId}
/
basic
Get Player Basic Info
curl --request GET \
  --url https://api.example.com/player/{membershipId}/basic
{
  "membershipId": "<string>",
  "membershipType": 123,
  "iconPath": "<string>",
  "displayName": "<string>",
  "bungieGlobalDisplayName": "<string>",
  "bungieGlobalDisplayNameCode": "<string>",
  "lastSeen": "<string>",
  "isPrivate": true,
  "cheatLevel": 123,
  "PlayerNotFoundError": {
    "membershipId": "<string>"
  }
}
An extremely low-cost API call to get basic Bungie information about a player. The information is not guaranteed to be fully up-to-date, but should be accurate enough for most use cases where you only have the membershipId available.

​
Path Parameters

​
membershipId
string
required
The Destiny membership ID of the player (int64 format).

​
Response

Returns a PlayerInfo object with basic player information.
​
membershipId
string
Destiny membership ID (int64 format).
​
membershipType
integer
The platform on which the player created their account.Valid values:
  • 1: Xbox
  • 2: PlayStation
  • 3: Steam
  • 4: Blizzard (deprecated)
  • 5: Stadia (deprecated)
  • 6: Epic Games Store
​
iconPath
string
Path to the player’s icon on Bungie’s CDN. Prepend https://www.bungie.net to get the full URL.
​
displayName
string
Platform-specific display name. No longer shown in-game.
​
bungieGlobalDisplayName
string
Bungie global display name (the part before the #).
​
bungieGlobalDisplayNameCode
string
Bungie name code (the part after the #). Display as bungieGlobalDisplayName#bungieGlobalDisplayNameCode.
​
lastSeen
string
ISO 8601 timestamp of when the player was last seen in a raid.
​
isPrivate
boolean
Whether the player has chosen to hide their profile on Bungie.net.
​
cheatLevel
integer
The level of cheating detected on the account.Values:
  • 0: None
  • 1: Suspicious
  • 2: Moderate
  • 3: Extreme
  • 4: Blacklisted

​
Example Request

curl -X GET "https://api.raidhub.io/player/4611686018488107374/basic" \
  -H "X-API-Key: your_api_key_here"

​
Example Response

{
  "minted": "2026-03-03T12:34:56.789Z",
  "success": true,
  "response": {
    "membershipId": "4611686018488107374",
    "membershipType": 3,
    "iconPath": "/common/destiny2_content/icons/93844c8b76ea80683a880479e3506980.jpg",
    "displayName": "xx_newo_xx",
    "bungieGlobalDisplayName": "Newo",
    "bungieGlobalDisplayNameCode": "9010",
    "lastSeen": "2021-05-01T00:00:00.000Z",
    "isPrivate": false,
    "cheatLevel": 0
  }
}

​
Error Responses

​
PlayerNotFoundError
object
Returned when the player is not found in the RaidHub database (404).

​
Example Error Response

{
  "minted": "2026-03-03T12:34:56.789Z",
  "success": false,
  "code": "PlayerNotFoundError",
  "error": {
    "membershipId": "4611686018488107374"
  }
}

​
Use Cases

  • Display player names: Show player information in UI without fetching full profile
  • Batch lookups: Quickly fetch basic info for multiple players
  • Lightweight checks: Verify a player exists before making more expensive API calls
  • Cache warm-up: Pre-fetch basic player data for better user experience

​
Performance Notes

This endpoint is optimized for speed and low cost:
  • Cached for 5 minutes (300 seconds)
  • Does not trigger expensive database queries
  • Information may be slightly out of date
  • Triggers an asynchronous refresh of player data in the background

Build docs developers (and LLMs) love

Get started for freeTalk to us