Get Player Basic Info

Get basic Bungie information about a player with minimal cost

GET /player/{membershipId}/basic

Get Player Basic Info

cURL

curl --request GET \
  --url https://api.example.com/player/{membershipId}/basic

200

{
  "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).

Show error

membershipId · string

The membership ID that was not found.

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