API:2/characters/:id/equipment
From Guild Wars 2 Wiki
< API:2 | characters
Jump to navigationJump to search/v2/characters/:id/equipment
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2015-05-22
- Scope
- account
builds
characters
inventories - Optional
- none
This resource returns information about the equipment on a character attached to a specific account.
Parameters
access_token
- (optional) If the API key is not specified in the request header, it can be specified here.
Response
equipment
(array) - An array containing an entry for each piece of equipment currently on the selected character.id
(integer) - The itemid
, resolvable against /v2/itemsslot
(string) - The equipment slot in which the item is slotted. Possible values:HelmAquatic
Backpack
Coat
Boots
Gloves
Helm
Leggings
Shoulders
Accessory1
Accessory2
Ring1
Ring2
Amulet
WeaponAquaticA
WeaponAquaticB
WeaponA1
WeaponA2
WeaponB1
WeaponB2
Sickle
Axe
Pick
infusions
(array) (optional) - returns an array of infusion itemids
which can be resolved against/v2/items
upgrades
(array) (optional) - returns an array of upgrade component itemids
which can be resolved against/v2/items
skin
(integer) (optional) - Skin id for the given equipment piece. Can be resolved against/v2/skins
stats
(object) (optional) - Contains information on the stats chosen if the item offers an option for stats/prefix.id
(integer) - The itemstat id, can be resolved against/v2/itemstats
attributes
(object) - Contains a summary of the stats on the item.Power
(integer) (optional) - Shows the amount of power givenPrecision
(integer) (optional) - Shows the amount of Precision givenToughness
(integer) (optional) - Shows the amount of Toughness givenVitality
(integer) (optional) - Shows the amount of Vitality givenCondition Damage
(integer) (optional) - Shows the amount of Condition Damage givenCondition Duration
(integer) (optional) - Shows the amount of Condition Duration givenHealing
(integer) (optional) - Shows the amount of Healing Power givenBoonDuration
(integer) (optional) - Shows the amount of Boon Duration given
binding
(string) (optional) - describes which kind of binding the item has. Possible values:Character
Account
charges
(number) (optional) - The amount of charges remaining on the item.bound_to
(string) (optional, only if character bound) - Name of the character the item is bound to.dyes
(array of numbers) - Array of selected dyes for the equipment piece. Values default tonull
if no dye is selected. Colors can be resolved againstv2/colors
Example
Request
https://api.guildwars2.com/v2/characters/<character name>/equipment Authorization: Bearer <API key> https://api.guildwars2.com/v2/characters/<character name>/equipment?access_token=<API key>
Response
{ "equipment": [ { "id": 47874, "slot": "HelmAquatic", "upgrades": [ 24836 ], "binding": "Character", "bound_to": "<Character name>" }, { "id": 72309, "slot": "Backpack", "infusions": [ 77310, 49433 ], "skin": 6561, "stats": { "id": 584, "attributes": { "Power": 63, "Precision": 40, "CritDamage": 40 } }, "binding": "Account" }, { "id": 48079, "slot": "Coat", "upgrades": [ 24836 ], "infusions": [ 49432 ], "skin": 5719, "binding": "Account" }, {...}, { "id": 22997, "slot": "Sickle", "binding": "Account", "charges": 31 }, { "id": 23000, "slot": "Axe", "binding": "Account", "charges": 7 }, { "id": 48933, "slot": "Pick", "binding": "Account" } ] }