Bungie
App · Gaming · 13 actions
Look up Destiny 2 players, profiles, and definitions, and read the current public milestones and game manifest, from the Bungie API.
Actions
| Action | What it does |
|---|---|
| Find a clan | Find a Destiny clan by its exact name. |
| Find a player | Find a Destiny 2 player's platform memberships by their Bungie Name (e.g. 'Guardian#1234'). |
| Get a clan | Get a Destiny clan's details by its group id. |
| Get a definition | Look up a single Destiny 2 definition (such as an item, class, or activity) by its hash. |
| Get clan members | List the members of a Destiny clan. |
| Get linked profiles | List all Destiny memberships linked to an account (useful for cross-save accounts). |
| Get manifest | Get the current Destiny 2 manifest version and the paths to its content databases. |
| Get match report | Get the Post Game Carnage Report (detailed match results) for a Destiny 2 activity. |
| Get profile | Get a Destiny 2 player's public profile. |
| Get public milestones | List the currently active public Destiny 2 milestones (this week's rotating activities). |
| Get recent matches | List a character's recent activities (matches), most recent first. |
| List characters | List a Destiny 2 player's characters, each with its character id (needed to read that character's recent matches). |
| Search users | Search Bungie users by the start of their Bungie Name (returns several matches). |
Find a clan
Find a Destiny clan by its exact name.
Inputs
- Clan name
nametextRequired - The clan's exact name.
Outputs
abouttext- The clan's description.
clan_callsigntext- The clan's callsign (tag).
creation_datetext- When the clan was created.
group_idtext- The clan's group id. Use with Get a clan.
member_countnumber- Number of members.
mottotext- The clan's motto.
nametext- The clan's name.
Example output
{
"about": "A friendly clan for all Guardians.",
"clan_callsign": "TLC",
"creation_date": "2017-09-01T00:00:00Z",
"group_id": "3011584",
"member_count": 87,
"motto": "Eyes up, Guardian.",
"name": "The Last City"
}Find a player
Find a Destiny 2 player's platform memberships by their Bungie Name (e.g. 'Guardian#1234').
Inputs
- Bungie Name
bungie_nametextRequired - The player's Bungie Name including the code, e.g. 'Guardian#1234'.
- Platform
membership_typetext - Which platform to search (default: all platforms).One of:
-1(All platforms),1(Xbox),2(PlayStation),3(Steam),4(Blizzard),5(Stadia),6(Epic Games). Default:-1.
Outputs
playerslist- The player's platform memberships.
Example output
{
"players": [
{
"bungie_global_display_name": "Guardian",
"bungie_global_display_name_code": 1234,
"cross_save_override": 3,
"display_name": "Guardian",
"icon_url": "https://www.bungie.net/img/theme/bungienet/icons/steamLogo.png",
"membership_id": "4611686018467284386",
"membership_type": 3
}
]
}Get a clan
Get a Destiny clan's details by its group id.
Inputs
- Clan group ID
group_idtextRequired - The clan's group id, from Find a clan.
Outputs
abouttext- The clan's description.
clan_callsigntext- The clan's callsign (tag).
creation_datetext- When the clan was created.
group_idtext- The clan's group id. Use with Get a clan.
member_countnumber- Number of members.
mottotext- The clan's motto.
nametext- The clan's name.
Example output
{
"about": "A friendly clan for all Guardians.",
"clan_callsign": "TLC",
"creation_date": "2017-09-01T00:00:00Z",
"group_id": "3011584",
"member_count": 87,
"motto": "Eyes up, Guardian.",
"name": "The Last City"
}Get a definition
Look up a single Destiny 2 definition (such as an item, class, or activity) by its hash.
Inputs
- Definition type
entity_typetextRequired - Which kind of definition to look up.One of:
DestinyInventoryItemDefinition(Item),DestinyClassDefinition(Class),DestinyActivityDefinition(Activity),DestinyVendorDefinition(Vendor),DestinyRaceDefinition(Race),DestinyMilestoneDefinition(Milestone). - Hash
hash_identifiertextRequired - The definition's numeric hash.
Outputs
definitionobject- The full definition object.
descriptiontext- Display description.
has_icontrue/false- Whether it has an icon.
hashnumber- The definition's hash.
nametext- Display name.
Example output
{
"definition": {
"hash": 3655393761
},
"description": "Disciplined and proud, Titans are capable of both...",
"has_icon": true,
"hash": 3655393761,
"name": "Titan"
}Get clan members
List the members of a Destiny clan.
Inputs
- Clan group ID
group_idtextRequired - The clan's group id, from Find a clan.
Outputs
countnumber- Number of members returned.
memberslist- The clan's members.
Example output
{
"count": 1,
"members": [
{
"display_name": "Guardian",
"display_name_code": 1234,
"is_online": false,
"join_date": "2020-01-01T00:00:00Z",
"member_type": 5,
"membership_id": "4611686018467284386",
"membership_type": 3
}
]
}Get linked profiles
List all Destiny memberships linked to an account (useful for cross-save accounts).
Inputs
- Platform
membership_typetextRequired - The player's platform, from Find a player.One of:
1(Xbox),2(PlayStation),3(Steam),4(Blizzard),5(Stadia),6(Epic Games). - Membership ID
membership_idtextRequired - The player's Destiny membership id, from Find a player.
Outputs
countnumber- Number of linked profiles.
profileslist- The linked Destiny memberships.
Example output
{
"count": 1,
"profiles": [
{
"bungie_global_display_name": "Guardian",
"bungie_global_display_name_code": 1234,
"cross_save_override": 3,
"display_name": "Guardian",
"icon_url": "https://www.bungie.net/img/theme/bungienet/icons/steamLogo.png",
"membership_id": "4611686018467284386",
"membership_type": 3
}
]
}Get manifest
Get the current Destiny 2 manifest version and the paths to its content databases.
Inputs
None.
Outputs
json_world_content_pathsobject- Per-locale paths to the aggregate JSON content.
mobile_world_content_pathsobject- Per-locale paths to the SQLite content databases.
versiontext- The manifest version (use as a cache key).
Example output
{
"json_world_content_paths": {
"en": "/common/destiny2_content/json/en/aggregate_7b.json"
},
"mobile_world_content_paths": {
"en": "/common/destiny2_content/sqlite/en/world_sql_content_5f.content"
},
"version": "239055.24.08.09.1730-6-bnet.57226"
}Get match report
Get the Post Game Carnage Report (detailed match results) for a Destiny 2 activity.
Inputs
- Activity ID
activity_idtextRequired - The activity (instance) id of the match.
Outputs
activity_hashnumber- The activity definition hash.
countnumber- Number of players in the report.
instance_idtext- The activity instance id.
modenumber- The activity mode code.
periodtext- When the match was played.
playerslist- Per-player results.
Example output
{
"activity_hash": 2229749170,
"count": 1,
"instance_id": "12345678901",
"mode": 5,
"period": "2026-08-01T12:00:00Z",
"players": [
{
"assists": 7,
"character_class": "Titan",
"deaths": 12,
"display_name": "Guardian",
"kills": 25,
"standing": 0
}
]
}Get profile
Get a Destiny 2 player's public profile. Which parts are returned depends on the components you pick and the player's privacy settings.
Inputs
- Platform
membership_typetextRequired - The player's platform, from Find a player.One of:
1(Xbox),2(PlayStation),3(Steam),4(Blizzard),5(Stadia),6(Epic Games). - Membership ID
membership_idtextRequired - The player's Destiny membership id, from Find a player.
- Include
componentslist - Which parts of the profile to fetch.One or more of:
100(Profile),200(Characters),202(Character progressions),204(Character activities),205(Character equipment),800(Collectibles),900(Records (Triumphs)).
Outputs
A Destiny 2 profile response, keyed by the components requested (e.g. 'profile', 'characters'), each wrapped as {data, privacy}.
Example output
{
"profile": {
"data": {
"dateLastPlayed": "2026-08-01T12:00:00Z",
"userInfo": {
"bungieGlobalDisplayName": "Guardian",
"bungieGlobalDisplayNameCode": 1234,
"membershipId": "4611686018467284386",
"membershipType": 3
}
},
"privacy": 1
}
}Get public milestones
List the currently active public Destiny 2 milestones (this week's rotating activities).
Inputs
None.
Outputs
milestoneslist- The active public milestones.
Example output
{
"milestones": [
{
"end_date": "2026-08-12T17:00:00Z",
"milestone_hash": 3603098564,
"order": 1,
"start_date": "2026-08-05T17:00:00Z"
}
]
}Get recent matches
List a character's recent activities (matches), most recent first. Each match's activity id can be fed to Get match report for full details.
Inputs
- Platform
membership_typetextRequired - The player's platform, from Find a player.One of:
1(Xbox),2(PlayStation),3(Steam),4(Blizzard),5(Stadia),6(Epic Games). - Membership ID
membership_idtextRequired - The player's Destiny membership id, from Find a player.
- Character ID
character_idtextRequired - The character id, from List characters.
- Activity type
modetext - Which activity type to include (default: all).One of:
0(All activities),2(Story),3(Strike),4(Raid),5(All PvP (Crucible)),7(All PvE),16(Nightfall),18(All Strikes),19(Iron Banner),63(Gambit),82(Dungeon),84(Trials of Osiris). Default:0. - How many
countnumber - How many matches to return (1-250).From 1 to 250. Default:
25. - Page
pagenumber - Page of results (0 is the most recent).At least 0. Default:
0.
Outputs
activitieslist- Recent activities, most recent first.
countnumber- Number of matches returned.
Example output
{
"activities": [
{
"assists": 7,
"completed": 1,
"deaths": 12,
"duration_seconds": 612,
"instance_id": "12345678901",
"is_private": false,
"kills": 25,
"mode": 5,
"period": "2026-08-01T12:00:00Z",
"reference_id": 2229749170,
"standing": 0
}
],
"count": 1
}List characters
List a Destiny 2 player's characters, each with its character id (needed to read that character's recent matches).
Inputs
- Platform
membership_typetextRequired - The player's platform, from Find a player.One of:
1(Xbox),2(PlayStation),3(Steam),4(Blizzard),5(Stadia),6(Epic Games). - Membership ID
membership_idtextRequired - The player's Destiny membership id, from Find a player.
Outputs
characterslist- The player's characters.
countnumber- Number of characters.
Example output
{
"characters": [
{
"character_id": "2305843009300000001",
"class_name": "Titan",
"class_type": 0,
"date_last_played": "2026-08-01T12:00:00Z",
"emblem_path": "/common/destiny2_content/icons/emblem.jpg",
"light": 1810,
"minutes_played_total": "54321",
"race_type": 0
}
],
"count": 1
}Search users
Search Bungie users by the start of their Bungie Name (returns several matches).
Inputs
- Name starts with
name_prefixtextRequired - The beginning of the Bungie Name to search for, e.g. 'Guard'.
- Page
pagenumber - Result page (starts at 0).At least 0. Default:
0.
Outputs
countnumber- Number of users on this page.
has_moretrue/false- Whether more pages exist.
resultslist- Matching users.
Example output
{
"count": 1,
"has_more": false,
"results": [
{
"bungie_global_display_name": "Guardian",
"bungie_global_display_name_code": 1234,
"bungie_net_membership_id": "19571657",
"destiny_memberships": [
{
"bungie_global_display_name": "Guardian",
"bungie_global_display_name_code": 1234,
"cross_save_override": 3,
"display_name": "Guardian",
"icon_url": "https://www.bungie.net/img/theme/bungienet/icons/steamLogo.png",
"membership_id": "4611686018467284386",
"membership_type": 3
}
]
}
]
}