The Guild Wars 2 API (application programming interface) is an interface that enables third-party applications to access data directly from the Guild Wars 2 servers. The current version of the API is version 2. For recent changes of the API, see the API changelog.
To discuss the Guild Wars 2 API, or in case of problems or required help, visit the official API development forums.
- Maps: How to use the map resources and the tile service to create maps.
Version 2 endpoints
The API version 2 provides the following endpoints:
These endpoints access account data and require an API key to view.
- account: Returns information about an account associated with an API key.
- account/achievements: Returns information about an account's achievement progress.
- account/bank: Returns information about a bank associated with an API key.
- account/dyes: Returns information about unlocked dyes associated with an API key.
- account/materials: Returns information about a material storage associated with an API key.
- account/minis: Returns information about unlocked miniatures associated with an API key.
- account/skins: Returns information about unlocked skins associated with an API key.
- account/wallet: Returns information about wealth associated with an API key.
- characters: Returns information on an account's characters.
- commerce/transactions: Returns information on an account's past and current trading post transactions.
- pvp/stats: Returns general information on a player's performance in sPvP.
- pvp/games: Returns more detailed information on the player's most recent sPvP matches.
- tokeninfo: Returns information about the supplied API Key.
- items: Returns information about items
- materials: Returns information about materials
- recipes: Returns information about recipes
- recipes/search: A search interface for recipes
- skins: Returns information about skins
- continents: Returns a list of continents and information about each continent
floors: Returns detailed information about a map floor
- maps: Returns information about maps in the game
- commerce/listings: Returns trading post listings
- commerce/exchange: Returns gem exchange prices
- commerce/prices: Returns buy and sell listing information
World vs. World
- wvw/matches: Returns information about current WvW matchups.
- wvw/objectives: Returns information about WvW objectives.
- achievements: Returns information about achievements
- achievements/daily: Returns information about daily achievements
- build: Returns the current build id
- colors: Returns information about dye colors
- currencies: Returns information about wallet currencies
- emblem: Returns image resources needed to render guild emblems.
- files: Returns commonly requested assets
- quaggans: Returns quaggan icons
- minis: Returns minis
- worlds: Returns world names
Version 1 endpoints
The API version 1 provides the following endpoints:
- events: Returns the current status of events for a specific world.
- Note: This endpoint is obsolete due to the implementation of Megaserver technology. There are plans to replace it with something that returns data about the rotating world bosses, but nothing specific has been announced.
- event_names: Returns a list of localized event names.
- map_names: Returns a list of localized map names.
- world_names: Returns a list of localized world names.
- event_details: Returns detailed information about events.
- guild_details: Returns detailed information about a guild.
- items: Returns a list of discovered items.
- item_details: Returns detailed information about an item.
- recipes: Returns a list of discovered recipes.
- recipe_details: Returns detailed information about a recipe.
- skins: Returns a list of skins.
- skin_details: Returns detailed information about a skin.
- continents: Returns a list of continents and information about each continent.
- maps: Returns a list of maps in the game.
- map_floor: Returns detailed information about a map floor
World vs. World
- wvw/matches: Returns the currently running WvW matches.
- wvw/match_details: Returns details about a WvW match.
- wvw/objective_names: Returns a list of WvW objective names.
- build: Returns the current build id.
- colors: Returns a list of dyes in the game.
- files: Returns commonly requested assets.
- Tile service: Provides world map tiles to create Guild Wars 2 maps
- Render service: Provides access to in-game assets.
- Additional resources are available as assets.
List of wrappers
- A list of wrapper libraries that provide high-level access to the API is available here.
List of applications
- A list of applications that use the API is available here.