Skip to main content
GET
/
player
/
{membershipId}
/
instances
Query Player Instances
curl --request GET \
  --url https://api.example.com/player/{membershipId}/instances
{
  "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).

​
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

Build docs developers (and LLMs) love

Get started for freeTalk to us