Skip to main content
GET
/
clan
/
{groupId}
curl --request GET \
  --url https://api.raidhub.io/clan/3148408 \
  --header 'Authorization: Bearer YOUR_API_KEY'
{
  "minted": "2026-03-03T23:30:00.000Z",
  "success": true,
  "response": {
    "aggregateStats": {
      "stats": {
        "clears": 15420,
        "averageClears": 154,
        "freshClears": 8760,
        "averageFreshClears": 88,
        "sherpas": 2340,
        "averageSherpas": 23,
        "timePlayedSeconds": 18504000,
        "averageTimePlayedSeconds": 185040,
        "totalContestScore": 12500.5,
        "weightedContestScore": 8750.25
      },
      "ranks": {
        "clearsRank": 42,
        "freshClearsRank": 38,
        "sherpasRank": 56,
        "timePlayedSecondsRank": 45,
        "totalContestScoreRank": 67,
        "weightedContestScoreRank": 54
      }
    },
    "members": [
      {
        "playerInfo": {
          "membershipId": "4611686018488107374",
          "membershipType": 3,
          "displayName": "Guardian_1",
          "bungieGlobalDisplayName": "Guardian",
          "bungieGlobalDisplayNameCode": "1234",
          "iconPath": "/common/destiny2_content/icons/default_avatar.jpg",
          "lastSeen": "2026-03-03T20:15:00.000Z",
          "isPrivate": false,
          "cheatLevel": 0
        },
        "stats": {
          "clears": 245,
          "freshClears": 180,
          "sherpas": 42,
          "totalTimePlayedSeconds": 294000,
          "contestScore": 150.5
        }
      },
      {
        "playerInfo": null,
        "stats": {
          "clears": 89,
          "freshClears": 45,
          "sherpas": 5,
          "totalTimePlayedSeconds": 106800,
          "contestScore": 0
        }
      }
    ]
  }
}
Get the stats for a clan. Data updates weekly.

Path Parameters

groupId
string
required
The unique identifier for the clan. This is the Bungie.net group ID.Example: 3148408

Response

aggregateStats
object
required
Aggregate statistics for the entire clan
members
array
required
Array of clan members with their individual statistics
curl --request GET \
  --url https://api.raidhub.io/clan/3148408 \
  --header 'Authorization: Bearer YOUR_API_KEY'
{
  "minted": "2026-03-03T23:30:00.000Z",
  "success": true,
  "response": {
    "aggregateStats": {
      "stats": {
        "clears": 15420,
        "averageClears": 154,
        "freshClears": 8760,
        "averageFreshClears": 88,
        "sherpas": 2340,
        "averageSherpas": 23,
        "timePlayedSeconds": 18504000,
        "averageTimePlayedSeconds": 185040,
        "totalContestScore": 12500.5,
        "weightedContestScore": 8750.25
      },
      "ranks": {
        "clearsRank": 42,
        "freshClearsRank": 38,
        "sherpasRank": 56,
        "timePlayedSecondsRank": 45,
        "totalContestScoreRank": 67,
        "weightedContestScoreRank": 54
      }
    },
    "members": [
      {
        "playerInfo": {
          "membershipId": "4611686018488107374",
          "membershipType": 3,
          "displayName": "Guardian_1",
          "bungieGlobalDisplayName": "Guardian",
          "bungieGlobalDisplayNameCode": "1234",
          "iconPath": "/common/destiny2_content/icons/default_avatar.jpg",
          "lastSeen": "2026-03-03T20:15:00.000Z",
          "isPrivate": false,
          "cheatLevel": 0
        },
        "stats": {
          "clears": 245,
          "freshClears": 180,
          "sherpas": 42,
          "totalTimePlayedSeconds": 294000,
          "contestScore": 150.5
        }
      },
      {
        "playerInfo": null,
        "stats": {
          "clears": 89,
          "freshClears": 45,
          "sherpas": 5,
          "totalTimePlayedSeconds": 106800,
          "contestScore": 0
        }
      }
    ]
  }
}

Notes

  • Clan statistics are updated weekly, so recent activity may not be immediately reflected
  • The playerInfo field will be null for members with private profiles
  • All time values are in seconds
  • The cheatLevel indicates the integrity status of a player’s account
  • Rankings are only available for clans that appear on the global leaderboards

Build docs developers (and LLMs) love