Bungie.Net API

Name: Bungie.Net API API
Brand: Bungie.Net API
Availability: InStock

✓ Official Vendor SpecMediaContent DeliveryapiKey, oauth2160 EndpointsREST

For Agents

Read Destiny 2 player profiles, inventories, and stats and perform in-game actions like equipping items, transferring loadouts, and managing clans on behalf of an authenticated player.

Quickstart

Get started with Bungie.Net API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"get a Destiny 2 player profile"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Bungie.Net API API.

Look up a player's Destiny 2 profile, characters, inventory, and progressions

Equip, transfer, lock, or pull from postmaster on Destiny 2 items

Snapshot, equip, and update Destiny 2 loadouts

Search Destiny entity definitions (items, perks, activities) by text

Manage clan and group membership, walls, and forums via GroupV2

GET STARTED

Start building with Bungie.Net API API

Explore with Jentic

View OpenAPI Document

The Bungie.Net API exposes the platform behind Bungie.net and the Destiny video games, covering player profiles, Destiny 2 character and inventory data, item actions, social features, fireteam finder, group/clan management, and content delivery for news and help articles. It is used by community sites, Destiny companion apps, and tools that read or modify a player's gameplay state. Read endpoints work with an X-API-Key, while operations that modify a player's data require OAuth 2.0 authorization with the appropriate scope.

Use Cases

Patterns agents use Bungie.Net API API for, with concrete tasks.

★ Destiny 2 companion app data

Power third-party companion apps that show a player's vault, characters, weapons, and progressions. The Destiny2 endpoints return profile components, character inventories, and item instances with manifest IDs that map to the public definition catalog. Apps typically combine this with the Destiny manifest to render rich item details client-side.

For a given Destiny 2 membershipId and membershipType, fetch the player's profile components and list their characters and equipped items.

In-game item actions on behalf of a player

Perform OAuth-scoped item actions like equipping a weapon, transferring an item between vault and character, locking a god-roll, or snapshotting a loadout. These are write operations that require the MoveEquipDestinyItems scope and a valid user OAuth token. They power loadout managers and DIM-style inventory tools.

POST to /Destiny2/Actions/Items/EquipItem/ with the itemInstanceId and characterId for a player who has authorized the MoveEquipDestinyItems scope, then verify by re-reading the character's equipped items.

Clan and fireteam management

Build clan dashboards and LFG tools using the GroupV2 and FireteamFinder endpoints. Read clan membership, post to clan walls with the appropriate scope, and create or browse open fireteam listings filtered by activity. Suitable for clan websites, Discord bots, and matchmaking utilities.

List open Fireteam Finder listings for a given activity graph hash and return the top results with their joinability and language.

AI agent Destiny assistant via Jentic

An AI assistant can read a player's current Destiny 2 state and execute scoped item actions on their behalf — for example, suggesting and equipping a loadout for a specific activity. Jentic stores the OAuth refresh token and the X-API-Key separately, so the agent only ever calls operations with scoped, short-lived credentials.

Search Jentic for 'equip a Destiny 2 loadout', load the EquipLoadout schema, then execute it with the player's characterId and chosen loadoutIndex after confirming the player intent.

Key Endpoints

160 endpoints — the bungie.

METHOD

PATH

DESCRIPTION

POST

/Destiny2/Actions/Items/EquipItem/

Equip an item on a character

POST

/Destiny2/Actions/Items/TransferItem/

Transfer an item between vault and character

POST

/Destiny2/Actions/Items/PullFromPostmaster/

Pull an item from the postmaster

POST

/Destiny2/Actions/Loadouts/EquipLoadout/

Equip a saved loadout

POST

/Destiny2/Actions/Loadouts/SnapshotLoadout/

Snapshot the current equipped state as a loadout

GET

/Destiny2/Armory/Search/{type}/{searchTerm}/

Search Destiny entity definitions

GET

/Content/Rss/NewsArticles/{pageToken}/

Fetch the Bungie.net news article feed

POST

/Destiny2/Actions/Items/EquipItem/

Equip an item on a character

POST

/Destiny2/Actions/Items/TransferItem/

Transfer an item between vault and character

POST

/Destiny2/Actions/Items/PullFromPostmaster/

Pull an item from the postmaster

POST

/Destiny2/Actions/Loadouts/EquipLoadout/

Equip a saved loadout

POST

/Destiny2/Actions/Loadouts/SnapshotLoadout/

Snapshot the current equipped state as a loadout

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Bungie X-API-Key and per-user OAuth refresh tokens are stored encrypted in the Jentic vault. Agents receive a scoped short-lived access token per operation, so the long-lived secrets never enter the agent's context.

Intent-based discovery

Agents search Jentic by intent (e.g., 'equip a Destiny 2 loadout') and Jentic returns the matching Destiny2 operation with its full request schema, including the required OAuth scope, so the agent picks the correct endpoint without reading Bungie docs.

Time to first call

Direct Bungie integration: 2-4 days for application registration, OAuth setup, and scope mapping. Through Jentic: under 1 hour — search, load schema, execute with vaulted credentials.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Riot Games API

Riot Games API exposes player and match data for League of Legends, Valorant, and TFT.

Pick Riot when the player or community is on a Riot title rather than Destiny — Bungie.Net is Destiny/Bungie-only.

Complementary

Steam Web API

Steam Web API for cross-game stats and friends data on the Steam platform.

Use alongside Bungie.Net when surfacing a player's broader Steam library next to their Destiny stats.

Alternative

Akamai API

Akamai's content delivery and edge network APIs for media-heavy applications.

Pick Akamai for general-purpose content delivery; Bungie.Net's content endpoints are scoped to Bungie/Destiny editorial content only.

FAQs

Specific to using Bungie.Net API API through Jentic.

What authentication does the Bungie.Net API use?

Every request requires an X-API-Key header obtained from https://www.bungie.net/en/Application. Operations that read or modify a user's data additionally require OAuth 2.0 authorization-code with scopes such as ReadDestinyInventoryAndVault or MoveEquipDestinyItems. Through Jentic, both the API key and the user OAuth refresh token are vault-scoped per call.

Can I equip a loadout on behalf of a Destiny 2 player?

Yes — POST /Destiny2/Actions/Loadouts/EquipLoadout/ swaps to a saved loadout. The request requires a valid OAuth token with the MoveEquipDestinyItems scope. Use SnapshotLoadout to capture the current state before swapping if you want a rollback.

How do I search for a Destiny 2 item by name?

GET /Destiny2/Armory/Search/{type}/{searchTerm}/ returns Destiny entity definitions matching the search term. Resolve the returned hashes against the Destiny manifest to get full item, perk, or activity details.

What are the rate limits for the Bungie.Net API?

The OpenAPI spec does not declare explicit limits. Bungie publishes throttle guidance in their developer documentation — most endpoints are subject to per-application and per-user quotas. Cache profile data where possible and avoid polling tighter than the platform's recommended cadence.

How do I read a player's Destiny 2 profile through Jentic?

Run `pip install jentic` and search for 'get a Destiny 2 player profile'. Jentic returns the matching GetProfile operation under Destiny2 with its component query parameter; load the schema and execute with the player's membershipType and membershipId — credentials stay in the Jentic vault.

Can I post to Bungie.net forums and clan walls with this API?

Yes. The Forum and GroupV2 endpoints support creating posts and replies. Posting to a clan wall requires the WriteGroups OAuth scope, and forum write operations require the BnetWrite scope, which Bungie restricts to elevated-trust applications.