Get Player Profile

Get a player’s complete profile including global stats, activity stats, and world first entries

GET /player/{membershipId}/profile

Get Player Profile

cURL

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

200

{
  "playerInfo": {
    "membershipId": "<string>",
    "bungieGlobalDisplayName": "<string>",
    "bungieGlobalDisplayNameCode": "<string>",
    "membershipType": 123,
    "iconPath": "<string>",
    "lastSeen": "<string>",
    "isPrivate": true,
    "cheatLevel": 123
  },
  "stats": {
    "global": {
      "clears": {
        "value": 123,
        "rank": 123,
        "percentile": 123
      },
      "freshClears": {},
      "sherpas": {},
      "totalTimePlayed": {},
      "contest": {},
      "sumOfBest": {}
    },
    "activity": {
      "{activityId}": {
        "activityId": 123,
        "freshClears": 123,
        "clears": 123,
        "sherpas": 123,
        "fastestInstance": {}
      }
    }
  },
  "worldFirstEntries": {
    "{activityId}": {
      "activityId": 123,
      "instanceId": "<string>",
      "timeAfterLaunch": 123,
      "rank": 123,
      "isDayOne": true,
      "isContest": true,
      "isWeekOne": true,
      "isChallengeMode": true
    }
  }
}

Get a player’s profile information used to hydrate the RaidHub profile page. This includes global statistics, per-activity statistics, and world first entries.

This endpoint requires authentication if the player has a private profile.

Path Parameters

membershipId · string · required

The Destiny membership ID of the player (int64 format).

Response

playerInfo · object

Basic information about the player.

Show PlayerInfo

membershipId · string

Destiny membership ID.

bungieGlobalDisplayName · string

Bungie global display name.

bungieGlobalDisplayNameCode · string

Bungie name code.

membershipType · integer

Platform the account was created on.

iconPath · string

Player icon path.

lastSeen · string

Last seen timestamp.

isPrivate · boolean

Whether the profile is private.

cheatLevel · integer

Cheat detection level (0-4).

stats · object

Player statistics.

Show stats

global · object

Global statistics across all raids.

Show global

clears · object

Total raid clears with rank and percentile.

Show GlobalStat

value · number

The stat value.

rank · integer

Leaderboard rank (null if not ranked).

percentile · number

Percentile rank from 0.0 to 1.0 (null if not ranked).

freshClears · object

Fresh (full) raid clears with rank and percentile.

sherpas · object

Number of first-timers helped with rank and percentile.

totalTimePlayed · object

Total time played in raids (seconds) with rank and percentile.

contest · object

Contest mode score with rank and percentile.

sumOfBest · object

Sum of best times across all raids with rank and percentile.

activity · object

Per-activity statistics, keyed by activityId.

Show activity

{activityId} · object

Statistics for a specific raid activity.

Show PlayerProfileActivityStats

activityId · integer

The RaidHub activity ID.

freshClears · integer

Number of fresh clears.

clears · integer

Total number of clears (fresh + checkpoint).

sherpas · integer

Number of first-timers helped.

fastestInstance · object

The player’s fastest completion of this activity (Instance object).

worldFirstEntries · object

World first rankings, keyed by activityId. Value is null if player didn’t complete during contest/day one.

Show worldFirstEntries

{activityId} · object

World first entry for a specific raid.

Show WorldFirstEntry

activityId · integer

The RaidHub activity ID.

instanceId · string

The instance ID of the completion.

timeAfterLaunch · integer

Seconds after raid launch when completed.

rank · integer

World first ranking position.

isDayOne · boolean

Completed during day one period.

isContest · boolean

Completed during contest mode period.

isWeekOne · boolean

Completed during week one period.

isChallengeMode · boolean

Was in challenge mode.

Example Request

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

Example Response

{
  "minted": "2026-03-03T12:34:56.789Z",
  "success": true,
  "response": {
    "playerInfo": {
      "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
    },
    "stats": {
      "global": {
        "clears": {
          "value": 450,
          "rank": 1250,
          "percentile": 0.95
        },
        "freshClears": {
          "value": 320,
          "rank": 1100,
          "percentile": 0.93
        },
        "sherpas": {
          "value": 45,
          "rank": 5000,
          "percentile": 0.85
        },
        "totalTimePlayed": {
          "value": 540000,
          "rank": 2000,
          "percentile": 0.90
        },
        "contest": {
          "value": 1500.5,
          "rank": 500,
          "percentile": 0.98
        },
        "sumOfBest": {
          "value": 25000,
          "rank": 750,
          "percentile": 0.96
        }
      },
      "activity": {
        "9": {
          "activityId": 9,
          "freshClears": 25,
          "clears": 40,
          "sherpas": 5,
          "fastestInstance": null
        }
      }
    },
    "worldFirstEntries": {
      "9": null,
      "12": {
        "activityId": 12,
        "instanceId": "12345678901234567",
        "timeAfterLaunch": 28800,
        "rank": 450,
        "isDayOne": true,
        "isContest": true,
        "isWeekOne": true,
        "isChallengeMode": false
      }
    }
  }
}

Error Responses

PlayerNotFoundError (404)

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

PlayerPrivateProfileError (403)

Returned when the player has a private profile and you don’t have authorization.

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

Use Cases

• Profile pages: Display comprehensive player statistics
• Leaderboard positioning: Show where a player ranks globally
• Achievement tracking: Display world first completions
• Progress tracking: Monitor player improvement over time

Performance Notes

• Cached for 30 seconds
• Triggers asynchronous player data refresh
• Returns 403 for private profiles without proper authentication