Common properties[edit]
The following properties are common to all items:
Common properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
item_id |
integer |
any integer number |
1..1 |
The item's unique id
|
name |
string |
any text |
1..1 |
The item's name, localized to the chosen language
|
description |
string |
any text, with markup tags |
1..1 |
The item's description, localized to the chosen language
|
type |
string
|
Types
|
Armor
|
Back
|
Bag
|
Consumable
|
Container
|
CraftingMaterial
|
Gizmo
|
MiniPet
|
Trinket
|
Trophy
|
UpgradeComponent
|
Weapon
|
|
1..1 |
The item's type
|
level |
integer |
0..80 |
1..1 |
The required level to use the item
|
rarity |
string
|
Rarities
|
Ascended
|
Basic
|
Exotic
|
Fine
|
Legendary
|
Masterwork
|
Rare
|
|
1..1 |
The item's rarity
|
vendor_value |
integer |
any integer number |
1..1 |
The value of the item in coin when sold to an NPC merchant
|
icon_file_id |
integer |
any integer number |
1..1 |
The icon file id to be used with the render service.
|
icon_file_signature |
string |
an alphanumeric string |
1..1 |
The icon file signature to be used with the render service.
|
game_types |
array of string
|
Game types
|
Activity
|
Dungeon
|
Pve
|
PvP
|
PvPLobby
|
WvW
|
|
1..∞ |
The game types where the item is usable.
|
flags |
array of strings
|
General item flags
|
AccountBound
|
HideSuffix
|
NoMysticForge
|
NoSell
|
NoSalvage
|
NoUnderwater
|
NotUpgradeable
|
SoulbindOnAcquire
|
SoulBindOnUse
|
Unique
|
|
0..∞ |
Common item flags
|
restrictions |
array of string
|
Restriction flags
|
Asura
|
Charr
|
Human
|
Norn
|
|
0..∞ |
Item usage restriction based on character race.
|
Additional item property
|
armor
|
bag
|
back
|
consumable
|
container
|
gizmo
|
trinket
|
weapon
|
|
string |
As described below |
0..1 |
Possible extra item information based on the item's type.
|
Armor properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
type |
string
|
Armor types
|
Boots
|
Coat
|
Gloves
|
Helm
|
HelmAquatic
|
Leggings
|
Shoulders
|
|
|
1..1 |
The armor type
|
weight_class |
string
|
Armor weight classes
|
Heavy
|
Light
|
Medium
|
|
1..1 |
The armor's weight class
|
defense |
integer |
any integer number |
1..1 |
The armor's defense rating
|
infusion_slots |
array of infusion slot flags
|
Infusion slot
|
Property identifier |
Property type |
Possible values |
Number of values |
Description
|
flags |
array of string
|
Infusion type flags
|
Defense
|
Offense
|
Utility
|
|
1..1 |
The type of infusion slot.
|
|
1..1 |
The armor's infusion slots
|
infix_upgrade |
class of infix upgrades
|
Buff class
|
Property identifier |
Property type |
Possible values |
Number of values |
Description
|
buff |
class of buff
|
Buff properties
|
Property identifier |
Property type |
Possible values |
Number of values |
Description
|
skill_id |
integer |
any skill id |
1..1 |
The skill linked to this buff.
|
description |
string |
any text string |
1..1 |
The skill's description.
|
|
0..1 |
The inherent skill for this item, if any
|
Attribute modifiers
|
Property identifier |
Property type |
Possible values |
Number of values |
Description
|
attributes |
array of Armor attribute modifiers
|
Armor attribute modifier
|
Property identifier |
Property type |
Possible values |
Number of values |
Description
|
attribute |
array of string
|
attribute types
|
ConditionDamage
|
CritDamage
|
Healing
|
Power
|
Precision
|
Toughness
|
Vitality
|
|
1..1 |
The type of armor attribute.
|
modifier |
integer |
any integer number |
1..1 |
The amount by which the attribute is increased
|
|
1..1 |
Always present, but can be empty
|
|
1..1 |
This armor's inherent upgrades
|
suffix_item_id |
integer |
any UpgradeComponent item id |
1..1 |
The item id of a pre-applied upgrade component. The property is always present but has empty value if the item has no suffix item.
|
|
Back properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
|
Bag properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
no_sell_or_sort |
integer |
0 or 1 |
1..1 |
A flag indicating whether that bag is of the "safe" or "invisible" type.
|
size |
integer |
any integer number |
1..1 |
The number of inventory slots that bag provides.
|
|
Consumable properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
type |
|
Consumable types
|
Food
|
Generic
|
Transmutation
|
Unknown
|
Unlock
|
Utility
|
|
1..1 |
The type of consumable
|
duration_ms |
integer |
any integer number |
0..1 |
only present for consumable types Food and Utility
|
description |
string |
any text |
0..1 |
only present for consumable types Food and Utility
|
unlock_type |
|
Consumable unlock types
|
CraftingRecipe
|
Dye
|
|
0..1 |
only present for consumable type Unlock
|
color_id |
integer |
any integer number |
0..1 |
only present for consumable unlock type Dye
|
recipe_id |
integer |
any recipe item id |
0..1 |
only present for consumable unlock type CraftingRecipe
|
|
Container properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
type |
string
|
Container types
|
Default
|
GiftBox
|
|
1..1 |
The type of container
|
|
Crafting material properties
|
No extra properties
|
|
Gizmo properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
type |
string
|
|
1..1 |
The type of gizmo
|
|
Mini pet properties
|
No extra properties
|
|
Trinket properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
|
Trophy properties
|
No extra properties
|
|
Upgrade component properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
|
Weapon properties
|
Property identifier |
Property type |
Possible values |
Number of instances |
Description
|
type |
string
|
Weapon types
|
Axe
|
Dagger
|
Focus
|
Greatsword
|
Hammer
|
Harpoon
|
LongBow
|
Mace
|
Pistol
|
Rifle
|
Scepter
|
Shield
|
ShortBow
|
Speargun
|
Sword
|
Staff
|
Torch
|
Trident
|
Warhorn
|
|
1..1 |
The weapon type
|
damage_type |
string
|
|
1..1 |
The weapon's damage type.
|
min_power |
integer |
any integer number |
1..1 |
The weapon's minimum power rating
|
max_power |
integer |
any integer number |
1..1 |
The weapon's maximum power rating
|
defense |
integer |
any integer number |
1..1 |
The weapon's defense rating
|
infusion_slots |
array of infusion slot flags
|
Infusion slot
|
Property identifier |
Property type |
Possible values |
Number of values |
Description
|
flags |
array of string
|
Infusion type flags
|
Defense
|
Offense
|
Utility
|
|
1..1 |
The type of infusion slot.
|
|
0..∞ |
The number and type of infusion slots on this weapon.
|
suffix_item_id |
integer |
any UpgradeComponent item id |
1..1 |
The item id of a pre-applied upgrade component. The property is always present but has empty value if the item has no suffix item.
|
|