Query Player Instances

Find raid instances for a player with advanced filtering options

GET /player/{membershipId}/instances

Query Player Instances

cURL

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

200

{
  "instances": [
    {
      "instanceId": "<string>",
      "hash": 123,
      "completed": true,
      "flawless": true,
      "fresh": true,
      "playerCount": 123,
      "skullHashes": [
        {}
      ],
      "score": 123,
      "dateStarted": "<string>",
      "dateCompleted": "<string>",
      "season": 123,
      "duration": 123,
      "platformType": 123,
      "activityId": 123,
      "versionId": 123,
      "isDayOne": true,
      "isContest": true,
      "isWeekOne": true,
      "isBlacklisted": true,
      "players": [
        {
          "membershipId": "<string>",
          "bungieGlobalDisplayName": "<string>",
          "bungieGlobalDisplayNameCode": "<string>",
          "membershipType": 123,
          "iconPath": "<string>",
          "lastSeen": "<string>",
          "isPrivate": true,
          "cheatLevel": 123
        }
      ]
    }
  ]
}

Find a set of instances based on query parameters with advanced filtering capabilities. This endpoint is useful for finding specific types of completions or analyzing player performance.

This endpoint requires authentication regardless of whether the player’s profile is private.

Path Parameters

membershipId · string · required

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

Query Parameters

Teammate Filters

membershipIds · string

Comma-separated list of up to 6 membershipIds that must be present in the instance.

You do not need to include the target membershipId from the path parameter in this list.

Example: 4611686018467890123,4611686018467890456

Activity Filters

activityId · integer

Filter by RaidHub activity ID (e.g., 9 for Vault of Glass).

versionId · integer

Filter by version ID (e.g., 1 for Normal, 2 for Master).

Completion Filters

completed · boolean

Filter by completion status.

• true: Only completed runs
• false: Only incomplete runs

fresh · boolean

Filter by fresh starts (started from beginning).

• true: Only fresh runs
• false: Only checkpoint runs

flawless · boolean

Filter by flawless status (no deaths).

• true: Only flawless runs
• false: Only non-flawless runs

Fireteam Size Filters

playerCount · integer

Exact player count (e.g., 3 for trio runs).

minPlayerCount · integer

Minimum player count (inclusive).

maxPlayerCount · integer

Maximum player count (inclusive).

Duration Filters

minDurationSeconds · integer

Minimum duration in seconds (inclusive).

maxDurationSeconds · integer

Maximum duration in seconds (inclusive).

Season Filters

season · integer

Exact Destiny season number.

minSeason · integer

Minimum season number (inclusive).

maxSeason · integer

Maximum season number (inclusive).

Date Filters

minDate · string

Minimum completion date (ISO 8601 format).

maxDate · string

Maximum completion date (ISO 8601 format).

Response

Returns an array of up to 100 matching instances with player information.

instances · array

Array of instances matching the query (maximum 100).

Show InstanceWithPlayers

instanceId · string

Unique instance identifier.

hash · integer

Bungie activity hash.

completed · boolean

Whether the instance was completed.

flawless · boolean

Flawless status.

fresh · boolean

Fresh start status.

playerCount · integer

Number of players.

skullHashes · array

Active modifier hashes.

score · integer

Final score.

dateStarted · string

Start timestamp.

dateCompleted · string

Completion timestamp.

season · integer

Destiny season.

duration · integer

Duration in seconds.

platformType · integer

Platform type (0 if mixed).

activityId · integer

RaidHub activity ID.

versionId · integer

RaidHub version ID.

isDayOne · boolean

Day one completion.

isContest · boolean

Contest mode completion.

isWeekOne · boolean

Week one completion.

isBlacklisted · boolean

Blacklisted from leaderboards.

players · array

Array of players in the instance.

Show PlayerInfo

membershipId · string

Player’s membership ID.

bungieGlobalDisplayName · string

Bungie name.

bungieGlobalDisplayNameCode · string

Bungie name code.

membershipType · integer

Platform type.

iconPath · string

Icon path.

lastSeen · string

Last seen timestamp.

isPrivate · boolean

Private profile status.

cheatLevel · integer

Cheat detection level.

Example Requests

Find Solo Flawless Runs

curl -X GET "https://api.raidhub.io/player/4611686018488107374/instances?playerCount=1&flawless=true&completed=true" \
  -H "X-API-Key: your_api_key_here" \
  -H "Authorization: Bearer your_token_here"

Find Runs with Specific Teammates

curl -X GET "https://api.raidhub.io/player/4611686018488107374/instances?membershipIds=4611686018467890123,4611686018467890456" \
  -H "X-API-Key: your_api_key_here" \
  -H "Authorization: Bearer your_token_here"

Find Fast Vault of Glass Clears

curl -X GET "https://api.raidhub.io/player/4611686018488107374/instances?activityId=9&completed=true&maxDurationSeconds=1800" \
  -H "X-API-Key: your_api_key_here" \
  -H "Authorization: Bearer your_token_here"

Example Response

{
  "minted": "2026-03-03T12:34:56.789Z",
  "success": true,
  "response": [
    {
      "instanceId": "12345678901234567",
      "hash": 3881495763,
      "completed": true,
      "flawless": true,
      "fresh": true,
      "playerCount": 1,
      "skullHashes": [],
      "score": 0,
      "dateStarted": "2021-05-01T18:00:00.000Z",
      "dateCompleted": "2021-05-01T20:15:00.000Z",
      "season": 14,
      "duration": 8100,
      "platformType": 3,
      "activityId": 9,
      "versionId": 1,
      "isDayOne": false,
      "isContest": false,
      "isWeekOne": false,
      "isBlacklisted": false,
      "players": [
        {
          "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 (404)

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

PlayerProtectedResourceError (403)

Returned when you don’t have permission to query the player’s instances.

{
  "minted": "2026-03-03T12:34:56.789Z",
  "success": false,
  "code": "PlayerProtectedResourceError",
  "error": {
    "message": "You do not have permission to query on this player's instances",
    "membershipId": "4611686018488107374"
  }
}

Filter Combinations

Some parameter combinations may conflict. For example, specifying a season outside the range of min/max season will return no results.

Common Query Patterns

• Low-man clears: completed=true&maxPlayerCount=3
• Solo runs: playerCount=1
• Trio flawless: playerCount=3&flawless=true
• Fast clears: completed=true&maxDurationSeconds=3600
• Recent activity: minDate=2026-01-01T00:00:00.000Z
• Fireteam runs: membershipIds=player1,player2,player3

Limits and Performance

• Maximum 100 instances returned per request
• Maximum 6 membershipIds in the teammate filter
• No pagination available - refine filters to get different results
• Authentication required for all requests
• Results are not cached to ensure data freshness

Use Cases

• Achievement verification: Confirm solo flawless or low-man completions
• Fireteam history: Find runs with specific groups
• Speed run analysis: Track fastest completion times
• Challenge tracking: Filter for specific modifiers or conditions
• Seasonal analysis: Compare performance across different seasons