recursal/Fanatic-Fandom huggingface dataset:
GetHistoricalStatsForAccount

## Summary

Gets aggregate historical stats organized around each character for a given account.

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/Stats/Account/2/4611686018428939884/

### **Response**

This response has been truncated to make it easier to see the full structure.

```
{
 "Response": {
 "mergedDeletedCharacters": {
 "results": {

 },
 "merged": {

 }
 },
 "mergedAllCharacters": {
 "results": {
 "allPvE": {
 "allTime": { // Note this is an associative array
 "weaponKillsSuper": {
 "statId": "weaponKillsSuper",
 "basic": {
 "value": 13374,
 "displayValue": "13374"
 },
 "pga": {
 "value": 3.11385331781,
 "displayValue": "3.1"
 }
 }
 }
 },
 "allPvP": {
 "allTime": {
 }
 }
 },
 "merged": {
 "allTime": {
 }
 }
 },
 "characters": [
 {
 "characterId": "2305843009214854213",
 "deleted": false,
 "results": {
 "allPvE": {
 "allTime": {
 }
 },
 "allPvP": {
 "allTime": {
 }
 }
 },
 "merged": {
 "allTime": {
 }
 }
 }
 ]
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ http://www.bungie.net/platform/Destiny/Help/HelpDetail/GET?uri=Stats%2fAccount%2f%7bmembershipType%7d%2f%7bdestinyMembershipId%7d%2f
GetDestinyManifest

## Summary

Returns the current version of the manifest as a json object.

## JSON POST Parameters

 "mobileAssetContentPath": "\/common\/destiny\_content\/sqlite\/asset\/asset\_sql\_content\_7c23eefeaa0003dbc141793135dae141.content",
 "mobileGearAssetDataBases": [
 {
 "version": 0,
 "path": "\/common\/destiny\_content\/sqlite\/asset\/asset\_sql\_content\_7c23eefeaa0003dbc141793135dae141.content"
 },
 {
 "version": 1,
 "path": "\/common\/destiny\_content\/sqlite\/asset\/asset\_sql\_content\_039b4a64b68a7ae75a1d349c301e494c.content"
 }
 ],
 "mobileWorldContentPaths": {
 "en": "\/common\/destiny\_content\/sqlite\/en\/world\_sql\_content\_bafce26a4daec6ba6932e93bb5bd200c.content",
 "fr": "\/common\/destiny\_content\/sqlite\/fr\/world\_sql\_content\_50895b556dfee93a1f3d5a3817c18b19.content",
 "es": "\/common\/destiny\_content\/sqlite\/es\/world\_sql\_content\_d016ba5a8d83b1526212bddaefbd96c6.content",
 "de": "\/common\/destiny\_content\/sqlite\/de\/world\_sql\_content\_52fbe64346a0110511a86238aec07310.content",
 "it": "\/common\/destiny\_content\/sqlite\/it\/world\_sql\_content\_bd613d541a690aa21896eb4ce761e42f.content",
 "ja": "\/common\/destiny\_content\/sqlite\/ja\/world\_sql\_content\_884749c1a137aa80b701fb175eb9620d.content",
 "pt-br": "\/common\/destiny\_content\/sqlite\/pt-br\/world\_sql\_content\_7a0cc97e802c88dee6a0ecff953194f2.content"
 },
 "mobileGearCDN": {
 "Geometry": "\/common\/destiny\_content\/geometry\/platform\/mobile\/geometry",
 "Texture": "\/common\/destiny\_content\/geometry\/platform\/mobile\/textures",
 "PlateRegion": "\/common\/destiny\_content\/geometry\/platform\/mobile\/plated\_textures",
 "Gear": "\/common\/destiny\_content\/geometry\/gear"
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ http://www.bungie.net/platform/Destiny/Help/HelpDetail/GET?uri=Manifest%2f
GetCurrentUserThrottleState

## Summary

Returns the throttle state for code redemption requests. Note: This may no longer be in use.

## Example

### **Request**

https://www.bungie.net/Platform/Tokens/ThrottleState/

### **Response**

```
{
 "Response": {
 "IsThrottled": false,
 "ThrottleExpires": "2000-01-01T00:01:00Z",
 "NumberOfFailedAttemptsToday": 0,
 "MaximumFailedAttemptsPerDay": 3,
 "AgeVerificationState": true
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetCurrentUserOfferHistory

## Summary

Returns a list of previously redeemed codes for the current account.

## JSON POST Parameters

 "OfferDisplayDetail": "Pick up your emblem at the Special Orders Vendor in the Tower.",
 "OfferImagePath": "\/img\/theme\/destiny\/icons\/icon\_glimmer.jpg",
 "OfferPurchaseDate": "2014-09-03T01:40:36.363Z",
 "OfferQuantity": 1,
 "ConsumableQuantity": 0,
 "RedeemType": 1
 }
 ],
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetDestinyLiveTileContentItems

## Summary

Returns a list of "tiles" used on the Bungie.net website.

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/LiveTiles

### **Response**

```
{
 "Response": [
 {
 "contentId": "12788",
 "cType": "LiveTile",
 "cmsPath": "HouseofWolvesDefault",
 "creationDate": "2015-04-20T18:55:12Z",
 "modifyDate": "2015-05-18T23:39:42Z",
 "allowComments": false,
 "hasAgeGate": false,
 "minimumAge": 0,
 "ratingImagePath": "",
 "author": {
 "membershipId": "8011",
 "uniqueName": "DeeJ",
 "displayName": "DeeJ",
 "profilePicture": 770057,
 "profileTheme": 67,
 "userTitle": 0,
 "successMessageFlags": "59",
 "isDeleted": false,
 "about": "Your friendly neighborhood Community Manager.",
 "firstAccess": "2004-10-29T18:14:49.77Z",
 "lastUpdate": "2015-02-27T23:28:26.83Z",
 "psnDisplayName": "DeeJ\_BNG",
 "xboxDisplayName": "DeeJ BNG",
 "showActivity": true,
 "followerCount": 15307,
 "followingUserCount": 265,
 "locale": "en",
 "localeInheritDefault": true,
 "showGroupMessaging": true,
 "profilePicturePath": "\/img\/profile\/avatars\/admin\/deej\_icon.jpg",
 "profileThemeName": "Destiny2",
 "userTitleDisplay": "Newbie"
 },
 "autoEnglishPropertyFallback": true,
 "properties": {
 "Title": "Destiny Expansion II ",
 "TileType": "Store",
 "Subtitle": "House of Wolves \u2013 Available Now",
 "DisplayDate": "",
 "ServiceLabel": "0",
 "ProductLabel": "DESTINYEXPNPACK2",
 "CategoryLabel": "",
 "WebPageLink": "",
 "FourByOne": "",
 "ThreeByOne": "",
 "TwoByOne": "\/pubassets\/37011\/HouseOfWolves.jpg",
 "OneByOne": ""
 },
 "representations": [
 {
 "name": "TwoByOne",
 "path": "\/pubassets\/37011\/HouseOfWolves.jpg",
 "validationString": "520x260 "
 }
 ],
 "tags": [

 ],
 "commentSummary": {
 "topicId": "0",
 "commentCount": 0
 }
 }
 ],
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
Unignore

## Example

### **Request**

POST https://www.bungie.net/Platform/Ignore/Unignore/

```
{
 "ignoredItemId":"8011",
 "ignoredItemType":3
}

```

### **Response**

```
{
 "Response":{
 "user":{
 "membershipId":"8011",
 "uniqueName":"DeeJ",
 "displayName":"DeeJ",
 "profilePicture":770057,
 "profileTheme":67,
 "userTitle":0,
 "successMessageFlags":"59",
 "isDeleted":false,
 "about":"Your friendly neighborhood Community Manager.",
 "firstAccess":"2004-10-29T18:14:49.77Z",
 "lastUpdate":"2015-02-27T23:28:26.83Z",
 "context":{
 "isFollowing":false,
 "ignoreStatus":{
 "isIgnored":false,
 "ignoreFlags":0
 }
 },
 "psnDisplayName":"DeeJ\_BNG",
 "xboxDisplayName":"DeeJ BNG",
 "showActivity":true,
 "followerCount":15375,
 "followingUserCount":265,
 "locale":"en",
 "localeInheritDefault":true,
 "showGroupMessaging":true,
 "profilePicturePath":"/img/profile/avatars/admin/deej\_icon.jpg",
 "profileThemeName":"Destiny2",
 "userTitleDisplay":"Newbie"
 },
 "displayName":"DeeJ",
 "dateCreated":"2015-05-29T14:15:23.732Z",
 "dateExpires":"2015-05-29T14:15:23.732Z",
 "dateModified":"2015-05-29T14:15:23.732Z",
 "comment":"",
 "flags":0,
 "reason":"0"
 },
 "ErrorCode":1,
 "ThrottleSeconds":0,
 "ErrorStatus":"Success",
 "Message":"Ok",
 "MessageData":{

 }
}

```
CreatePost

## JSON POST Parameters

 category
 groupId
 isGroupPrivate
 metadata
 parentPostId
 subTopicOverride
 subject
 urlLinkOrImage

## Example

### **Request**

POST https://www.bungie.net/Platform/Forum/CreatePost/

```
{
 "parentPostId":"122410116",
 "subTopicOverride":false,
 "subject":"",
 "body":"{postBody}",
 "category":0,
 "groupId":39966,
 "isGroupPrivate":null,
 "urlLinkOrImage":"",
 "metadata":""
}

```

### **Response**

```
{
 "Response": {
 "postId":"126596110",
 "parentPostId":"122410116",
 "topicId":"122410116",
 "threadDepth":2,
 "category":1,
 "authorMembershipId":"5197148",
 "body":"{postBody}",
 "urlLinkOrImage":"",
 "creationDate":"2015-06-02T06:47:46.062Z",
 "lastModified":"0001-01-01T00:00:00Z",
 "editCount":0,
 "replyCount":0,
 "topicReplyCount":0,
 "ratingCount":1,
 "rating":53,
 "upvotes":1,
 "downvotes":0,
 "ratingScore":1,
 "groupOwnerId":"39966",
 "isGroupPrivate":false,
 "flags":0,
 "lockedForReplies":false,
 "parentAuthorId":"68974",
 "topicAuthorId":"68974",
 "isTopicBanned":false,
 "actualParentPostId":"122410116",
 "playerSupportFlags":0,
 "pinned":0,
 "IsPinned":false,
 "popularity":1,
 "isActive":false,
 "isAnnouncement":false,
 "userRating":100,
 "userHasRated":true,
 "userHasMutedPost":false,
 "latestReplyPostId":"0",
 "latestReplyAuthorId":"0",
 "ignoreStatus": {
 "isIgnored":false,
 "ignoreFlags":0
 }
 },
 "ErrorCode":1,
 "ThrottleSeconds":0,
 "ErrorStatus":"Success",
 "Message":"Ok",
 "MessageData":{

 }
}

```
GetVendorItemDetailForCurrentCharacter

## Summary

Returns an item from a Vendor's inventory for a given character.

## Path Parameters

 characterId
 vendorId
 itemId

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/2/MyAccount/Character/2305843009234425075/Vendor/134701236/Item/16/

### **Response**

```
{
 "Response": {
 "data": {
 "itemDetail": {
 "item": {
 "itemHash": 2121165344,
 "bindStatus": 0,
 "isEquipped": false,
 "itemInstanceId": "-9223372036854775808",
 "itemLevel": 0,
 "stackSize": 1,
 "qualityLevel": 0,
 "stats": [

 ],
 "canEquip": false,
 "equipRequiredLevel": 0,
 "unlockFlagHashRequiredToEquip": 2166136261,
 "cannotEquipReason": 0,
 "damageType": 0,
 "damageTypeNodeIndex": -1,
 "damageTypeStepIndex": -1,
 "talentGridHash": 0,
 "nodes": [

 ],
 "useCustomDyes": true,
 "artRegions": {

 },
 "isEquipment": true,
 "isGridComplete": false,
 "perks": [

 ],
 "location": 3,
 "transferStatus": 2,
 "locked": false,
 "lockable": false
 },
 "talentNodes": [

 ],
 "statsOnNodes": {

 },
 "characterStatsToDisplay": [

 ],
 "materialItemHashes": [

 ]
 },
 "vendorItemIndex": 16,
 "itemStatus": 0,
 "costs": [
 {
 "itemHash": 3159615086,
 "value": 550
 }
 ]
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetDestinyExplorerTalentNodeSteps

## Query String Parameters

 page
 count
 name
 direction
 weaponPerformance
 impactEffects
 guardianAttributes
 lightAbilities
 damageTypes

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/Explorer/TalentNodeSteps/

### **Response**

```
{
 "Response": {
 "data": {
 "stepHashes": [
 3449542313,
 2187318329,
 556087844,
 2230841297,
 1927582060,
 1788601689,
 1098891289,
 2641311924,
 912099836,
 1221123134
 ],
 "totalResults": "469",
 "hasMore": true,
 "query": {
 "itemsPerPage": 10,
 "currentPage": 0
 },
 "useTotalResults": true
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetDestinySingleDefinition

## Summary

Returns the specific item from the current manifest a json object.

## JSON POST Parameters

 "icon": "\/common\/destiny\_content\/icons\/icon\_pvp\_d0a189071d8eb5d009f4252bef78b551.png",
 "releaseIcon": "\/img\/misc\/missing\_icon.png",
 "releaseTime": 0,
 "activityLevel": 0,
 "completionFlagHash": 0,
 "activityPower": 0,
 "minParty": 1,
 "maxParty": 6,
 "maxPlayers": 12,
 "destinationHash": 2777041980,
 "placeHash": 4088006058,
 "activityTypeHash": 3614615911,
 "tier": -1,
 "pgcrImage": "\/img\/theme\/destiny\/bgs\/pgcrs\/crucible\_twilight\_gap\_2.jpg",
 "rewards": [

 ],
 "skulls": [

 ]
 }
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ http://www.bungie.net/platform/Destiny/Help/HelpDetail/GET?uri=Manifest%2f%7btype%7d%2f%7bid%7d%2f
ApproveGroupMembershipV2

## Summary

Approve a member into a given group that the current user is an admin for.

## Old Endpoints

* /Group/{groupId}/Members/{membershipId}/Approve/

## JSON POST Parameters

```
{
 "message": "Congrats! You are now part of a super exclusive Destiny clan of awesomeness!!"
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {}
}

```

## References

1. ↑ https://www.bungie.net/Scripts/bungienet/clans/clans.min.js
GetAccount

## Summary

Returns Destiny account information for the supplied membership.

## JSON POST Parameters

 ]
 },
 {
 "itemHash":3455371673,
 "dyes":[
 {
 "channelHash":662199250,
 "dyeHash":4168297850
 },
 {
 "channelHash":1367384683,
 "dyeHash":2711136537
 },
 {
 "channelHash":218592586,
 "dyeHash":689527522
 }
 ]
 },
 {
 "itemHash":3338086101,
 "dyes":[
 {
 "channelHash":662199250,
 "dyeHash":789637384
 },
 {
 "channelHash":1367384683,
 "dyeHash":2691267825
 },
 {
 "channelHash":218592586,
 "dyeHash":3137458580
 }
 ]
 },
 {
 "itemHash":2966036517,
 "dyes":[
 {
 "channelHash":662199250,
 "dyeHash":659689519
 },
 {
 "channelHash":1367384683,
 "dyeHash":1664797271
 },
 {
 "channelHash":218592586,
 "dyeHash":863822665
 }
 ]
 },
 {
 "itemHash":619241014,
 "dyes":[
 {
 "channelHash":662199250,
 "dyeHash":789637385
 },
 {
 "channelHash":1367384683,
 "dyeHash":2691267824
 },
 {
 "channelHash":218592586,
 "dyeHash":3137458581
 }
 ]
 },
 {
 "itemHash":534017969,
 "dyes":[
 {
 "channelHash":662199250,
 "dyeHash":2309489318
 },
 {
 "channelHash":1367384683,
 "dyeHash":4170385287
 },
 {
 "channelHash":218592586,
 "dyeHash":4120174566
 }
 ]
 },
 {
 "itemHash":1040188249,
 "dyes":[
 {
 "channelHash":1667433279,
 "dyeHash":401101184
 },
 {
 "channelHash":1667433278,
 "dyeHash":3599482519
 }
 ]
 },
 {
 "itemHash":2167009337,
 "dyes":[
 {
 "channelHash":1667433279,
 "dyeHash":1365861629
 },
 {
 "channelHash":1667433278,
 "dyeHash":1477711958
 }
 ]
 },
 {
 "itemHash":1883086571,
 "dyes":[
 {
 "channelHash":1667433279,
 "dyeHash":1355270032
 },
 {
 "channelHash":1667433278,
 "dyeHash":1607044263
 }
 ]
 },
 {
 "itemHash":526316387,
 "dyes":[
 {
 "channelHash":284967655,
 "dyeHash":2090051647
 },
 {
 "channelHash":840921382,
 "dyeHash":52698514
 }
 ]
 },
 {
 "itemHash":3703598457,
 "dyes":[
 {
 "channelHash":2025709351,
 "dyeHash":794303093
 }
 ]
 },
 {
 "itemHash":1040215532,
 "dyes":[
 {
 "channelHash":4023194814,
 "dyeHash":1242556826
 }
 ]
 },
 {
 "itemHash":1443409297,
 "dyes":[

 ]
 },
 {
 "itemHash":4248210736,
 "dyes":[

 ]
 }
 ]
 },
 "genderType":0,
 "classType":2,
 "buildStatGroupHash":2172613790
 },
 "levelProgression":{
 "dailyProgress":20650,
 "weeklyProgress":64000,
 "currentProgress":5429712,
 "level":67,
 "step":0,
 "progressToNextLevel":69712,
 "nextLevelAt":80000,
 "progressionHash":2030054750
 },
 "emblemPath":"/common/destiny\_content/icons/ca7a9bb4a45b7d33a4848577a67cfa33.jpg",
 "backgroundPath":"/common/destiny\_content/icons/0fc2957b437530a6fec4b241257089bd.jpg",
 "emblemHash":1443409297,
 "characterLevel":32,
 "baseCharacterLevel":20,
 "isPrestigeLevel":true,
 "percentToNextLevel":0.0
 }
 ],
 "clanName":"TTL Gunslingers",
 "clanTag":"TTL",
 "inventory":{
 "buckets":{
 "Invisible":[

 ],
 "Item":[

 ],
 "Currency":[

 ]
 },
 "currencies":[
 {
 "itemHash":3159615086,
 "value":24576
 }
 ]
 },
 "grimoireScore":2585
 }
 },
 "ErrorCode":1,
 "ThrottleSeconds":0,
 "ErrorStatus":"Success",
 "Message":"Ok",
 "MessageData":{

 }
}

```

## References

1. ↑ https://www.bungie.net/platform/destiny/help/HelpDetail/GET?uri=%7bmembershipType%7d%2fAccount%2f%7bdestinyMembershipId%7d%2f
HistoricalStatsDefinition

## Structure

```
historicalStatsDefinition = {
 "statId": "fastestCompletion",
 "group": 1,
 "periodTypes": [
 3 // see PeriodType
 ],
 "modes": [
 7 // see DestinyActivityModeType
 ],
 "category": 0,
 "statName": "Fastest Completion",
 "unitType": 3, // see UnitType
 "unitLabel": "",
 "weight": 1
}

```

## References

* PeriodType
* DestinyActivityModeType
* UnitType
GetExcellenceBadges

## Summary

Returns Destiny excellence badges for a given account. No longer in use.

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/Stats/GetExcellenceBadges/2/4611686018428939884/?definitions=true

### **Response**

```
{
 "Response": {
 "data": {
 "badges": [
 {
 "badgeHashId": 10,
 "ackState": {
 "needsAck": true,
 "ackId": "4\_10"
 }
 },
 {
 "badgeHashId": 11,
 "ackState": {
 "needsAck": true,
 "ackId": "4\_11"
 }
 }
 ]
 },
 "definitions": {
 "badges": {
 "10": {
 "badgeHashId": 10,
 "badgeName": "Queen's Wrath Badge",
 "badgeDescription": "Gain rank 1 of the Queen's Reputation.",
 "tier": 1,
 "largeImageUrl": "\/img\/theme\/destiny\/icons\/profilebadges\/queen\_tier1.png",
 "smallImageUrl": "\/img\/theme\/destiny\/icons\/profilebadges\/queen\_small\_tier1.png"
 },
 "11": {
 "badgeHashId": 11,
 "badgeName": "Queen's Wrath Badge",
 "badgeDescription": "Gain rank 2 of the Queen's Reputation.",
 "tier": 2,
 "largeImageUrl": "\/img\/theme\/destiny\/icons\/profilebadges\/queen\_tier2.png",
 "smallImageUrl": "\/img\/theme\/destiny\/icons\/profilebadges\/queen\_small\_tier2.png"
 }
 }
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ https://www.bungie.net/en/Clan/Post/39966/118496335/0/0/1
Destiny Endpoints

* /Destiny/{membershipType}/Account/{destinyMembershipId}/
* /Destiny/Stats/ActivityHistory/{membershipType}/{destinyMembershipId}/{characterId}/
* /Destiny/{membershipType}/Account/{destinyMembershipId}/Character/{characterId}/Activities/
* /Destiny/{membershipType}/Account/{destinyMembershipId}/Character/{characterId}/Inventory/
* /Destiny/{membershipType}/Account/{destinyMembershipId}/Character/{characterId}/Progression/
* /Destiny/{membershipType}/Account/{destinyMembershipId}/Character/{characterId}/
* /Destiny/Stats/AggregateActivityStats/{membershipType}/{destinyMembershipId}/{characterId}/
* /Destiny/Manifest/
* /Destiny/Manifest/{type}/{id}/
* /Destiny/Stats/GetExcellenceBadges/{membershipType}/{destinyMembershipId}/
* /Destiny/Vanguard/Grimoire/{membershipType}/{membershipId}/
* /Destiny/Vanguard/Grimoire/Definition/
* /Destiny/Stats/{membershipType}/{destinyMembershipId}/{characterId}/
* /Destiny/Stats/Definition/
* /Destiny/Stats/Account/{membershipType}/{destinyMembershipId}/
* /Destiny/{membershipType}/Account/{destinyMembershipId}/Character/{characterId}/Inventory/{itemInstanceId}/
* /Destiny/{membershipType}/Stats/GetMembershipIdByDisplayName/{displayName}/
* /Destiny/Stats/PostGameCarnageReport/{activityId}/
* /Destiny/Stats/UniqueWeapons/{membershipType}/{destinyMembershipId}/{characterId}/
* /Destiny/SearchDestinyPlayer/{membershipType}/{displayName}/
TransferItem

## Summary

Moves items to and from a character and the vault.

## JSON POST Parameters

 itemReferenceHash
 itemId
 stackSize
 characterId
 transferToVault

## Example

### **Request**

POST https://www.bungie.net/Platform/Destiny/TransferItem

```
{
 "membershipType": 2,
 "itemReferenceHash": "2166567782",
 "itemId": "6917529050196876642",
 "stackSize": 1,
 "characterId": "2305843009234425075",
 "transferToVault": true
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetCharacterSummary

## Summary

Returns Destiny character information for the given characterId.
To get a more detailed overview, see the private endpoint GetDestinyAccountCharacterComplete.

## Path Parameters

 destinyMembershipId
 characterId

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/2/Account/4611686018428939884/Character/2305843009221011538/

### **Response**

```
{
 "Response": {
 "data": {
 "characterBase": {
 "membershipId": "4611686018428939884",
 "membershipType": 2,
 "characterId": "2305843009221011538",
 "dateLastPlayed": "2015-05-25T15:35:30Z",
 "minutesPlayedThisSession": "90",
 "minutesPlayedTotal": "33654",
 "powerLevel": 34,
 "raceHash": 2803282938,
 "genderHash": 2204441813,
 "classHash": 671679327,
 "currentActivityHash": 0,
 "lastCompletedStoryHash": 0,
 "stats": {
 "STAT\_DEFENSE": {
 "statHash": 3897883278,
 "value": 1786,
 "maximumValue": 0
 },
 "STAT\_INTELLECT": {
 "statHash": 144602215,
 "value": 297,
 "maximumValue": 0
 },
 "STAT\_DISCIPLINE": {
 "statHash": 1735777505,
 "value": 74,
 "maximumValue": 0
 },
 "STAT\_STRENGTH": {
 "statHash": 4244567218,
 "value": 197,
 "maximumValue": 0
 },
 "STAT\_LIGHT": {
 "statHash": 2391494160,
 "value": 168,
 "maximumValue": 0
 },
 "STAT\_ARMOR": {
 "statHash": 392767087,
 "value": 8,
 "maximumValue": 0
 },
 "STAT\_AGILITY": {
 "statHash": 2996146975,
 "value": 7,
 "maximumValue": 0
 },
 "STAT\_RECOVERY": {
 "statHash": 1943323491,
 "value": 1,
 "maximumValue": 0
 },
 "STAT\_OPTICS": {
 "statHash": 3555269338,
 "value": 49,
 "maximumValue": 0
 }
 },
 "customization": {
 "personality": 2166136261,
 "face": 2695914758,
 "skinColor": 1815484271,
 "lipColor": 2844894625,
 "eyeColor": 1511637752,
 "hairColor": 2555993491,
 "featureColor": 2166136261,
 "decalColor": 1609827955,
 "wearHelmet": false,
 "hairIndex": 12,
 "featureIndex": 0,
 "decalIndex": 0
 },
 "grimoireScore": 3405,
 "peerView": {
 "equipment": [
 {
 "itemHash": 144553853,
 "dyes": [
 {
 "channelHash": 662199250,
 "dyeHash": 1844830118
 }
 ]
 }
 ]
 },
 "genderType": 1,
 "classType": 1,
 "buildStatGroupHash": 3457215711
 },
 "levelProgression": {
 "dailyProgress": 30221,
 "weeklyProgress": 397956,
 "currentProgress": 11734708,
 "level": 146,
 "step": 0,
 "progressToNextLevel": 54708,
 "nextLevelAt": 80000,
 "progressionHash": 2030054750
 },
 "emblemPath": "\/common\/destiny\_content\/icons\/552621dd6b31a1d088d72e640b86ebb8.jpg",
 "backgroundPath": "\/common\/destiny\_content\/icons\/495a7949cf4a439ba4dc0c26ab9105c8.jpg",
 "emblemHash": 3656150980,
 "characterLevel": 34,
 "baseCharacterLevel": 20,
 "isPrestigeLevel": true,
 "percentToNextLevel": 0
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ http://www.bungie.net/platform/Destiny/Help/HelpDetail/GET?uri=Stats%2fActivityHistory%2f%7bmembershipType%7d%2f%7bdestinyMembershipId%7d%2f%7bcharacterId%7d%2f
ApprovePendingForList

## Summary

Approve specified pending members for a group that the current user is an admin for.

## Example

### **Request**

POST https://www.bungie.net/Platform/Group/177526/Members/ApproveList/

```
{
 "membershipIds": [5197148],
 "message": "Congrats! You are now part of a super exclusive Destiny clan of awesomeness!!"
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {}
}

```

## References

1. ↑ https://www.bungie.net/Scripts/bungienet/clans/clans.min.js
UpdateNotificationSetting

## Summary

Updates the current user's notification settings.

## Example

### **Request**

POST https://www.bungie.net/Platform/User/Notification/Update/

```
{
 "settings": [{
 "notificationType": 1,
 "notifyEmail": false,
 "notifyMobile": false,
 "notifyWeb": false
 }]
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetMyGrimoire

## Summary

Returns the Grimoire for the currently signed in account.

## Query String Parameters

 flavour
 single

## JSON POST Parameters

 ],
 "bonuses": [

 ]
 },
 "cardDefinitions": {
 "101005": {
 "cardId": 101005,
 "cardName": "Guardians",
 "cardIntro": "<b>&quot;Legends are carved across history by the brave.&quot;<\/b>",
 "cardDescription": "Guardians are warriors forged in the Traveler&#39;s Light, a final hope in a universe falling into Darkness.<br\/><br\/>\nChosen from the dead by the Traveler&#39;s Ghosts, Guardians are those rare few able to wield the Light as a weapon. For centuries they have defended the City. But that defense cannot hold forever.<br\/><br\/>\nNow, with the Darkness rising again, the time has come to retake our lost worlds. The Guardians who lead the way will save humanity - and become legend.",
 "unlockHowToText": "Unlock this card by playing Destiny.",
 "rarity": 1,
 "unlockFlagHash": 0,
 "points": 0,
 "normalResolution": {
 "image": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 419,
 "width": 323
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/images\/Classes-csprites\_d1fdb3b82ef2fccdc9619346ee0bb09e.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 838,
 "width": 1292
 }
 },
 "smallImage": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 83,
 "width": 83
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/images\/Classes-csprites-sm\_572c6179bebaf61f87ab21b188386d01.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 83,
 "width": 664
 }
 }
 },
 "highResolution": {
 "image": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 728,
 "width": 560
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/hr\_images\/101005\_5c51debee5418264ebc94bac161f42c2.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 728,
 "width": 560
 }
 },
 "smallImage": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 145,
 "width": 145
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/hr\_images\/Classes-csprites-sm\_000c72c7cff77c1c5844ca8c813fd2c0.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 145,
 "width": 1160
 }
 }
 }
 }
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetMembersOfGroupV3

## Summary

Returns a list of members for a given group.

## Old Endpoints

* /Group/{groupId}/Members/
* /Group/{groupId}/MembersV2/

## Query String Parameters

 currentPage
 memberType
 platformType
 sort
 nameSearch

## Example

### **Request**

https://www.bungie.net/Platform/Group/177526/MembersV3/?currentPage=1

### **Response**

```
{
 "Response": {
 "results": [
 {
 "user": {
 "membershipId": "5197148",
 "uniqueName": "5197148",
 "displayName": "lowlines",
 "profilePicture": 70525,
 "profileTheme": 84,
 "userTitle": 0,
 "successMessageFlags": "33",
 "isDeleted": false,
 "about": "",
 "firstAccess": "2014-07-18T08:03:04.916Z",
 "lastUpdate": "2015-03-10T04:12:13.322Z",
 "context": {
 "isFollowing": false,
 "ignoreStatus": {
 "isIgnored": false,
 "ignoreFlags": 0
 }
 },
 "psnDisplayName": "lowlines",
 "xboxDisplayName": "Low Lines",
 "showActivity": true,
 "followerCount": 48,
 "followingUserCount": 52,
 "locale": "en",
 "localeInheritDefault": true,
 "showGroupMessaging": true,
 "profilePicturePath": "\/img\/profile\/avatars\/bungieday\_03.jpg",
 "profileThemeName": "bungieday1303",
 "userTitleDisplay": "Newbie"
 },
 "hasPendingApplication": false,
 "hasRated": false,
 "approvalDate": "2014-09-02T09:08:36.038Z",
 "approvedByMembershipId": "5197148",
 "rating": 0,
 "groupId": "177526",
 "membershipType": 0,
 "membershipId": "5197148",
 "isMember": true,
 "memberType": 2,
 "isOriginalFounder": true
 }
 ],
 "totalResults": "5",
 "hasMore": false,
 "query": {
 "groupId": "177526",
 "memberType": -1,
 "platformType": 0,
 "sort": 0,
 "nameSearch": "",
 "itemsPerPage": 10,
 "currentPage": 1
 },
 "useTotalResults": true
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
SetQuestTrackedState

## JSON POST Parameters

 membershipId
 characterId
 itemId
 state

## Example

### **Request**

POST https://www.bungie.net/Platform/Destiny/SetQuestTrackedState/

```
{
 "membershipType": "2",
 "membershipId": "4611686018428939884",
 "characterId": "2305843009221011538",
 "itemId": "6917529057237444288",
 "state": "true"
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
ActivityTypeDefinition

## Structure

```
activityTypeDefinition = {
 "activityTypeHash": 0,
 "identifier": "ACTIVITY\_NULL",
 "activityTypeName": "undefinedActivityType",
 "activityTypeDescription": "Face your fellow Guardians in open combat. Prove your worth, and you will be rewarded.",
 "icon": "\/common\/destiny\_content\/icons\/icon\_pvp\_43319e992dcbb18bf0936a2fab0c946a.png",
 "activeBackgroundVirtualPath": "\/img\/destiny\_content\/ActivityTypeBackground\/Active\/crucible.png",
 "completedBackgroundVirtualPath": "\/img\/destiny\_content\/ActivityTypeBackground\/Completed\/crucible.png",
 "hiddenOverrideVirtualPath": "\/img\/destiny\_content\/ActivityTypeBackground\/Hidden\/crucible.png",
 "tooltipBackgroundVirtualPath": "\/img\/destiny\_content\/ActivityTypeBackground\/Tooltip\/crucible.png",
 "enlargedActiveBackgroundVirtualPath": "\/img\/destiny\_content\/ActivityTypeBackground\/Active\/crucible.png",
 "enlargedCompletedBackgroundVirtualPath": "\/img\/destiny\_content\/ActivityTypeBackground\/Completed\/crucible.png",
 "enlargedHiddenOverrideVirtualPath": "\/img\/destiny\_content\/ActivityTypeBackground\/Hidden\/crucible.png",
 "enlargedTooltipBackgroundVirtualPath": "\/img\/destiny\_content\/ActivityTypeBackground\/Tooltip\/crucible.png",
 "order": 6,
 "statGroup": "lockdown",
 "friendlyUrlId": "salvage"
}

```
DisableClanForGroup

## Summary

Disables clan features for a group that the current user is an admin for.

## Example

### **Request**

POST https://www.bungie.net/Platform/Group/177526/Clans/Disable/2/

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ https://www.bungie.net/Scripts/bungienet/clans/clans.min.js
GetCountsForCurrentUser

## Summary

Returns number of bungie.net notifications

## Example

### **Request**

https://www.bungie.net/Platform/User/GetCounts/

### **Response**

```
{
 "Response":{
 "onlineFriendCount":9,
 "notificationCount":2,
 "messageCount":4,
 "needReauth":2,
 "lastUpdated":"2015-05-27T13:20:31.385Z"
 },
 "ErrorCode":1,
 "ThrottleSeconds":0,
 "ErrorStatus":"Success",
 "Message":"Ok",
 "MessageData":{

 }
}

```
X-CSRF

## What is X-CSRF?

X-CSRF is a HTTP header you must provide to make use of private endpoints. It is a security measure to prevent Cross Site Request Forgeries (CSRF attacks).

## What value do I put in it?

The exact value of the bungled cookie.

```
X-CSRF: *bungled-cookie-value*

```

## ErrorCode 99

If you try to make use of a private endpoint without including a valid X-CSRF header and token, you will receive a "Please sign-in to continue." response.

```
{
 "ErrorCode":99,
 "ThrottleSeconds":0,
 "ErrorStatus":"WebAuthRequired",
 "Message":"Please sign-in to continue.",
 "MessageData":{

 }
}

```
GetMembersOfClan

## Summary

Returns a paged list of members in a clan.

## Query String Parameters

 memberType
 sort
 platformType

## Example

### **Request**

https://www.bungie.net/Platform/Group/177526/ClanMembers/

### **Response**

```
{
 "Response": {
 "results": [
 {
 "bungieNetUserInfo": {
 "iconPath": "\/img\/profile\/avatars\/bungieday\_03.jpg",
 "membershipType": 254,
 "membershipId": "5197148",
 "displayName": "lowlines"
 },
 "hasPendingApplication": false,
 "hasRated": false,
 "approvalDate": "2014-09-02T09:08:36.038Z",
 "approvedByMembershipId": "5197148",
 "rating": 0,
 "groupId": "177526",
 "membershipType": 254,
 "membershipId": "5197148",
 "isMember": true,
 "memberType": 2,
 "isOriginalFounder": true
 }
 ],
 "totalResults": "1",
 "hasMore": false,
 "query": {
 "groupId": "177526",
 "memberType": -1,
 "platformType": 2,
 "sort": 0,
 "nameSearch": "",
 "itemsPerPage": 10,
 "currentPage": 1
 },
 "useTotalResults": true
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {}
}

```
API Key

## What is an API key?

The API key is used by Bungie to measure who and what is using the API.

## How do I get one?

Visit the developer portal on bungie.net.

## How do I use it?

In a HTTP request, include the following header:

```
X-API-Key: *your-api-key-here*

```

## Is the key mandatory?

Yes, although as of May, 2015, it is not being enforced. However, you should include one now to avoid your application breaking in the future.
Kingdom Event

#### Basic Rule

You can participate in Kingdom Event if your Stronghold level is above 5. Completing required actions can obtain event points for your Kingdom. At the end of the Event, Top 1 Kingdom will get massive Gold Mines and Silver Mines as Prizes. Other Kingdoms will also get some participation prizes.

#### Cross Kingdom Teleport

You can teleport to other Kingdoms during the Kingdom Event by using Advanced Teleport item. You can attack, scout, gather and scramble relics after teleporting. Once you teleport to another kingdom, the system will start an 8 hours countdown. Your city will be randomly teleported to your own kingdom after the kingdom event or the countdown is over. Cities from other kingdom will be shown as RED on Kingdom map.

#### Rules of Relics in Kingdom Event

##### **Scrambling Time**

No matter what the state of the Relics is, the Relics will be under scrambling when the Kingdom Event starts. Scrambling time is the same as the Kingdom Event time. Alliances from other Kingdom can attack relics during the event. The leader will become Expedition, if his/her alliance occupies Relics/Tower. His/her alliance will get scrambling points at the same time.

##### **Conquered period**

After the scramble war, if a foreign kingdom's alliance gets the highest points, the Relics and Tower will be under conquered. During this period, players cannot fight for the Relics and Tower. There will not be a king but a conqueror (the top-ranked alliance leader). The positions of Duke will be vacant.

##### **Conqueror/Expedition**

Conqueror/Expedition cannot get King/Duke title and buff from the conquered kingdom. But he/she can arrange titles in Relics to those players who are from the kingdom he/she conquered. Only Conqueror and his/her alliance will get a large amount of Gold as rewards after scrambling, and Silver per day during Conquered Period.

#### Questions about Kingdom Event

Q1:Can I teleport to any Kingdom during the event?

A: You can only teleport to the Kingdoms which participate this event.

Q2: Can I reinforce allies in other Kingdom?

A:Sorry for that you can’t. If you want to reinforce your allies in other Kingdom, please teleport to the Kingdom he/she is in first. So is Rally Donation and Transporting.
EquipItem

## Summary

Equips an item from a character's inventory. The endpoint will fail if the character is logged in and doing an activity.

## Query String Parameters

 characterId
 itemId

## Example

### **Request**

POST https://www.bungie.net/Platform/Destiny/EquipItem

```
{
 "membershipType": 2,
 "itemId": "6917529044280138738",
 "characterId": "2305843009234425075"
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetUniqueWeaponHistory

## Summary

Gets details about unique weapon usage, including all exotic weapons.

## Path Parameters

 destinyMembershipId
 characterId

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/Stats/UniqueWeapons/2/4611686018428939884/2305843009214854213/

### **Response**

```
{
 "Response": {
 "data": {
 "weapons": [
 {
 "referenceId": 2344494718,
 "values": {
 "uniqueWeaponKills": {
 "statId": "uniqueWeaponKills",
 "basic": {
 "value": 422,
 "displayValue": "422"
 }
 },
 "uniqueWeaponPrecisionKills": {
 "statId": "uniqueWeaponPrecisionKills",
 "basic": {
 "value": 20,
 "displayValue": "20"
 }
 },
 "uniqueWeaponKillsPrecisionKills": {
 "statId": "uniqueWeaponKillsPrecisionKills",
 "basic": {
 "value": 0.0473933649289,
 "displayValue": "5%"
 }
 }
 }
 }
 ]
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ http://www.bungie.net/platform/Destiny/Help/HelpDetail/GET?uri=Stats%2fUniqueWeapons%2f%7bmembershipType%7d%2f%7bdestinyMembershipId%7d%2f%7bcharacterId%7d%2f
GetVault

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/2/MyAccount/Vault/?accountId=4611686018428939884

### **Response**

```
{
 "Response": {
 "data": {
 "buckets": [
 {
 "items": [
 {
 "itemHash": 1096028869,
 "bindStatus": 0,
 "isEquipped": false,
 "itemInstanceId": "6917529042526510940",
 "itemLevel": 20,
 "stackSize": 1,
 "qualityLevel": 60,
 "stats": [
 {
 "statHash": 2391494160,
 "value": 30,
 "maximumValue": 0
 }
 ],
 "primaryStat": {
 "statHash": 3897883278,
 "value": 402,
 "maximumValue": 0
 },
 "canEquip": false,
 "equipRequiredLevel": 20,
 "unlockFlagHashRequiredToEquip": 3720682193,
 "cannotEquipReason": 16,
 "damageType": 0,
 "damageTypeNodeIndex": -1,
 "damageTypeStepIndex": -1,
 "progression": {
 "dailyProgress": 0,
 "weeklyProgress": 0,
 "currentProgress": 127500,
 "level": 9,
 "step": 0,
 "progressToNextLevel": 0,
 "nextLevelAt": 17000,
 "progressionHash": 262790308
 },
 "talentGridHash": 1542531262,
 "nodes": [
 {
 "isActivated": false,
 "stepIndex": 0,
 "state": 0,
 "hidden": false,
 "nodeHash": 2355026416
 }
 ],
 "useCustomDyes": false,
 "artRegions": {

 },
 "isEquipment": true,
 "isGridComplete": false,
 "perks": [
 {
 "iconPath": "\/common\/destiny\_content\/icons\/7bae5fb01662288f1e2dbb528af9f4dc.png",
 "perkHash": 2152652275,
 "isActive": true
 }
 ],
 "location": 2,
 "transferStatus": 0,
 "locked": false,
 "lockable": true
 }
 ],
 "bucketHash": 3003523923
 }
 ]
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
GetPublicVendorWithMetadata

## Summary

Returns Public information for a given Vendor, with metadata.

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/Vendors/1527174714/Metadata/

### **Response**

```
{
 "Response": {
 "data": {
 "vendor": {
 "vendorHash": 1527174714,
 "nextRefreshDate": "2015-10-14T09:00:00Z",
 "enabled": true,
 "saleItemCategories": [
 {
 "categoryTitle": "Available Bounties",
 "saleItems": [
 {
 "item": {
 "itemHash": 837448826,
 "bindStatus": 0,
 "isEquipped": false,
 "itemInstanceId": "0",
 "itemLevel": 0,
 "stackSize": 1,
 "qualityLevel": 0,
 "stats": [],
 "canEquip": true,
 "equipRequiredLevel": 0,
 "unlockFlagHashRequiredToEquip": 0,
 "cannotEquipReason": 0,
 "damageType": 0,
 "damageTypeNodeIndex": -1,
 "damageTypeStepIndex": -1,
 "talentGridHash": 0,
 "nodes": [],
 "useCustomDyes": false,
 "artRegions": {},
 "isEquipment": false,
 "isGridComplete": false,
 "perks": [],
 "location": 3,
 "transferStatus": 2,
 "locked": false,
 "lockable": false,
 "objectives": [],
 "state": 0
 },
 "vendorItemIndex": 93,
 "itemStatus": 0,
 "costs": [],
 "requiredUnlockFlags": [],
 "unlockStatuses": [],
 "failureIndexes": []
 }
 ]
 }
 ],
 "canPurchase": false,
 "currencies": {}
 },
 "featuredSaleIndexes": [],
 "itemMetadata": {
 "837448826": {
 "itemHash": 837448826,
 "images": [],
 "videos": [],
 "sourceItemHash": 0
 }
 },
 "relatedItemSections": []
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {}
}

```
GrimoireDefinition

## Structure

```
grimoireDefinition = {
 "themeCollection": [
 {
 "themeId": "Guardian",
 "themeName": "Guardian",
 "normalResolution": {
 "image": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 419,
 "width": 323
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/images\/themes-sprites\_113f32d6872123b0c1d988ac607e7f85.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 419,
 "width": 1938
 }
 },
 "smallImage": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 83,
 "width": 83
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/images\/themes-sprites-sm\_5af5d0da49f96e1ebed78cc404451d4e.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 83,
 "width": 498
 }
 }
 },
 "highResolution": {
 "image": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 728,
 "width": 560
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/hr\_images\/guardian\_cb3f78f3caf4dff7d78cc50c4059d53e.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 728,
 "width": 560
 }
 },
 "smallImage": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 145,
 "width": 145
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/hr\_images\/themes-sprites-sm\_1f8064001472fa6dbc6a1a88522a47c1.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 145,
 "width": 870
 }
 }
 },
 "pageCollection": [
 {
 "pageId": "Classes",
 "pageName": "Classes",
 "normalResolution": {
 "image": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 419,
 "width": 323
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/images\/Guardian-psprites\_e43728852557b6967b624e4061a75eff.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 838,
 "width": 1292
 }
 },
 "smallImage": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 83,
 "width": 83
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/images\/Guardian-psprites-sm\_f3b72b9c5cb7d047d90d4ab2f32b1469.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 83,
 "width": 664
 }
 }
 },
 "highResolution": {
 "image": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 728,
 "width": 560
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/hr\_images\/classes\_85f921bc30d8a5d7a3488e32ef94b1fd.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 728,
 "width": 560
 }
 },
 "smallImage": {
 "rect": {
 "x": 0,
 "y": 0,
 "height": 145,
 "width": 145
 },
 "sheetPath": "\/common\/destiny\_content\/grimoire\/hr\_images\/Guardian-psprites-sm\_5e96fc9f56737ba112234ad27dc3166e.jpg",
 "sheetSize": {
 "x": 0,
 "y": 0,
 "height": 145,
 "width": 1160
 }
 }
 },
 "cardBriefs": [
 {
 "cardId": 101005,
 "points": 0,
 "totalPoints": 0
 }
 ]
 }
 ]
 }
 ]
}

```
GetGrimoireByMembership

## Summary

Returns the Grimoire for a given account.

## Query String Parameters

 flavour
 single

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/Vanguard/Grimoire/2/4611686018428939884/?single=101010

### **Response**

```
{
 "Response": {
 "data": {
 "score": 3475,
 "cardCollection": [
 {
 "cardId": 101010,
 "score": 40,
 "points": 0,
 "statisticCollection": [
 {
 "statNumber": 1,
 "value": 100041,
 "displayValue": "100041",
 "rankCollection": [
 {
 "rank": 1,
 "points": 5
 },
 {
 "rank": 2,
 "points": 5
 },
 {
 "rank": 3,
 "points": 5
 }
 ]
 },
 {
 "statNumber": 2,
 "value": 4196,
 "displayValue": "4196",
 "rankCollection": [
 {
 "rank": 1,
 "points": 5
 },
 {
 "rank": 2,
 "points": 5
 }
 ]
 },
 {
 "statNumber": 3,
 "value": 5904,
 "displayValue": "5904",
 "rankCollection": [
 {
 "rank": 1,
 "points": 5
 },
 {
 "rank": 2,
 "points": 5
 },
 {
 "rank": 3,
 "points": 5
 }
 ]
 }
 ]
 }
 ],
 "cardsToHide": [

 ],
 "bonuses": [

 ]
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ http://www.bungie.net/platform/Destiny/Help/HelpDetail/GET?uri=Vanguard%2fGrimoire%2f%7bmembershipType%7d%2f%7bmembershipId%7d%2f
GetPendingClanMemberships

## Summary

Get a paged list of pending members for a clan in a given group that the current user is an admin for.

## Path Parameters

 clanMembershipType
 currentPage

## Example

### **Request**

https://www.bungie.net/Platform/Group/177526/Clan/2/Pending/1/

### **Response**

```
{
 "Response": {
 "users": {},
 "groups": {},
 "memberships": {},
 "invitations": {
 "results": [],
 "totalResults": "0",
 "hasMore": false,
 "query": {
 "itemsPerPage": 10,
 "currentPage": 1
 },
 "useTotalResults": true
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {}
}

```
ApproveAllPending

## Summary

Approve all pending members for a group that the current user is an admin for.

## JSON POST Parameters

```
{
 "message": "Congrats! You are now part of a super exclusive Destiny clan of awesomeness!!"
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {}
}

```

## References

1. ↑ https://www.bungie.net/Scripts/bungienet/clans/clans.min.js
InviteClanMember

## Summary

Send a member an invitation to join the clan.

## Path Parameters

 membershipId
 clanMembershipType

## Example

### **Request**

POST https://www.bungie.net/Platform/Group/177526/InviteToClan/5197148/2/

```
{
 "title": "",
 "message": "Join our clan bro!"
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {}
}

```
GetActivityHistory

## Summary

Returns recent activity history for a given character.

## Path Parameters

 destinyMembershipId
 characterId

## Query String Parameters

 modes
 count
 page

## Example

### **Request**

https://www.bungie.net/Platform/Destiny/Stats/ActivityHistory/2/4611686018428939884/2305843009214854213/?mode=ArenaChallenge

### **Response**

```
{
 "Response": {
 "data": {
 "activities": [
 {
 "period": "2015-05-27T09:54:13Z",
 "activityDetails": {
 "referenceId": 1441430567,
 "instanceId": "2612614223",
 "mode": 22
 },
 "values": {
 "assists": {
 "statId": "assists",
 "basic": {
 "value": 29,
 "displayValue": "29"
 }
 },
 "completed": {
 "statId": "completed",
 "basic": {
 "value": 1,
 "displayValue": "Yes"
 }
 },
 "deaths": {
 "statId": "deaths",
 "basic": {
 "value": 9,
 "displayValue": "9"
 }
 },
 "kills": {
 "statId": "kills",
 "basic": {
 "value": 246,
 "displayValue": "246"
 }
 },
 "killsDeathsRatio": {
 "statId": "killsDeathsRatio",
 "basic": {
 "value": 27.3333333333,
 "displayValue": "27.33"
 }
 },
 "killsDeathsAssists": {
 "statId": "killsDeathsAssists",
 "basic": {
 "value": 28.9444444444,
 "displayValue": "28.94"
 }
 },
 "activityDurationSeconds": {
 "statId": "activityDurationSeconds",
 "basic": {
 "value": 3283,
 "displayValue": "54m 43s"
 }
 },
 "completionReason": {
 "statId": "completionReason",
 "basic": {
 "value": 0,
 "displayValue": "0"
 }
 },
 "fireTeamId": {
 "statId": "fireTeamId",
 "basic": {
 "value": 0,
 "displayValue": ""
 }
 },
 "playerCount": {
 "statId": "playerCount",
 "basic": {
 "value": 4,
 "displayValue": "4"
 }
 }
 }
 }
 ]
 }
 },
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```
API Details

## Endpoints

Each API endpoint is located under https://www.bungie.net/platform. Some endpoints require you to be authorised and cannot be used without additional parameters being passed to the platform. All endpoints return RESTful JSON .

## Minimum Request Requirements

When making a request to the platform, you **must** include the following headers in addition to standard HTTP request headers (i.e. Host):

* X-API-Key

Requests should be made using HTTPS.

## Minimum Private Endpoint Requirements

In addition to the minimum request requirements above, private endpoints requiring authentication must provide additional details when making requests to the platform. These include:

### **Headers**

* X-CSRF
* Cookie [see below]

### **Cookies**

Bungie.net needs to identify which account is making a request, which is of course done using cookies. You will need to provide, at a minimum, the following cookies:

* bungleatk
* bungled
* ~~bungles~~ (no longer needed)

You should also provide the following cookies to aid in diagnostic tasks:

* bungledid

## Minimum Response Details

Each endpoint returns a single JSON-encoded object with at least the following properties:

* ErrorCode *(integer)*
* ErrorStatus *(string)*
* Message *(string)*
* MessageData *(object)*
* Response *(mixed)*
* ThrottleSeconds *(integer)*

## Response Check

If the request returns the error 'WebAuthRequired' you can use the APItest script to find the problem.

## References

1. ↑ https://www.bungie.net/en/Clan/Post/39966/85087279/0/0/1
EditGroupV2

## Summary

Edit a group that the current user is an admin for.

## Example

### **Request**

POST https://www.bungie.net/Platform/Group/177526/EditV2/

```
{
 "name": "ClanName",
 "clanCallsign": "CLNM",
 "motto": "Motto goes here",
 "about": "Mission statement goes here.",
 "tags": ""
}

```

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {

 }
}

```

## References

1. ↑ https://www.bungie.net/Scripts/bungienet/clans/clans.min.js
UnfollowGroupWithGroup

## Summary

Unfollow another group followed by a group the current user is an admin for.

## Example

### **Request**

POST https://www.bungie.net/Platform/Group/{groupId}/Unfollow/{followGroupId}/

### **Response**

```
{
 "Response": 0,
 "ErrorCode": 1,
 "ThrottleSeconds": 0,
 "ErrorStatus": "Success",
 "Message": "Ok",
 "MessageData": {}
}

```

## References

1. ↑ https://www.bungie.net/Scripts/bungienet/clans/clans.min.js