API:2/skills

This resource returns information about skills usable by players in the game.

Parameters

lang – Request localized information.

Response

If the root endpoint (/v2/skills) is accessed without specifying an id, a list of all ids is returned. When multiple ids are requested using the ids parameter, a list of response objects is returned.

For each requested skill id, an object with the following properties is returned:

id (number) – The skill id.
name (string) – The skill name.
description (string, optional) – The skill description.
icon (string) – A URL to an icon of the skill.
chat_link (string) – The chat link.
type (string, optional) – The skill type (see below). Possible values:
- Bundle – Used for Engineer kits or weapons picked up in-world.
- Elite – Elite skill.
- Heal – Heal skill.
- Monster – Used for some NPC skills.
- Pet – Used for Ranger pet skills.
- Profession – Profession-specific skill, such as Elementalist attunements or Engineer toolbelt skills.
- Toolbelt – Used for some Engineer toolbelt skills.
- Transform – Placeholder skill used to indicate a locked slot.
- Utility – Utility skill.
- Weapon – Weapon skill or downed skill.
- Note this value is inconsistently set on certain skills triggered by traits, and may be unset..
weapon_type (string, optional) – Indicates what weapon the skill is on. Can also be None if not applicable.
professions (array) – An array of strings indicating which profession(s) can use this skill.
slot (string, optional) – A string indicating where this skill fits into. Possible values:
- Downed_[1-4] – Downed skills 1-4.
- Pet - Used for Ranger pet skills.
- Profession_[1-5] – Profession skills 1-5.
- Utility – Utility skill.
- Weapon_[1-5] – Weapon skills 1-5.
facts (array, optional) – An array of skill fact objects describing the skill's effect. (See below.)
traited_facts (array, optional) – An array of skill fact objects that may apply to the skill, dependent on the player's trait choices.
categories (array, optional) – An array of categories the skill falls under. Mostly used for organizational purposes, with some exceptions:
- DualWield – Indicates the skill is a dual-wield skill for thieves. The necessary off-hand weapon is indicated in dual_wield.
- StealthAttack – Indicates the skill can only be used by a thief in stealth.
- All other values of this field simply indicate which group of skills it belongs to. (i.e. Signet, Cantrip, etc.)
attunement (string, optional) – Used for Elementalist weapon skills, indicates what attunement this skill falls under. One of: Fire, Water, Air, Earth.
cost (number, optional) – Used for Revenant, Warrior, and Druid skills to indicate their energy cost.
dual_wield (string, optional) – Indicates what off-hand must be equipped for this dual-wield skill to appear.
flip_skill (number, optional) – Used for skills that "flip over" into a new skill in the same slot to indicate what skill they flip to, such as Engineer toolkits or Herald facets.
initiative (number, optional) – Indicates the Initiative cost for thief skills.
next_chain (number, optional) – Indicates the next skill in the chain, if applicable.
prev_chain (number, optional) – Indicates the previous skill in the chain, if applicable.
transform_skills (array of numbers, optional) – Used to indicate that the skill will transform the player, replacing their skills with the skills listed in the array.
bundle_skills (array of numbers, optional) – Used to indicate that the skill will replace the player's skills with the skills listed in the array.
toolbelt_skill (number, optional) – Used for Engineer utility skills to indicate their associated toolbelt skill.
flags (array, optional) – Used to indicate usage limitations, more than one value can be set. One of: GroundTargeted, NoUnderwater.
specialization (number, optional) – Used to indicate which elite specialization can use the skill.

Traited Facts

All objects returned within a traited_facts array contain the same properties as a facts object, but they additionally have the following properties:

requires_trait (number) – Specifies which trait has to be selected in order for this fact to take effect.
overrides (number, optional) – This specifies the array index of the facts object it will override, if the trait specified in requires_trait is selected. If this field is omitted, then the fact contained within this object is to be appended to the existing facts array.

Facts

All objects returned within a facts array contain the following properties:

text (string) – An arbitrary localized string describing the fact.
icon (string, optional) – A URL to the icon shown with the fact. Not included with all facts.
type (string) – Defines what additional fields the object will contain, and what type of fact it is. Can be one of the following:
- AttributeAdjust
- Buff
- ComboField
- ComboFinisher
- Damage
- Distance
- Duration
- Heal
- HealingAdjust
- NoData
- Number
- Percent
- PrefixedBuff
- Radius
- Range
- Recharge
- StunBreak
- Time
- Unblockable

AttributeAdjust

{
  text: "Attribute Adjust",
  type: "AttributeAdjust",
  icon: "url",
  value: 150,
  target: "CritDamage"
}

value (number) – The amount target gets adjusted, based on a level 80 character at base stats.
target (string) – The attribute this fact adjusts. Note that a value of Healing indicates the fact is a heal, and Ferocity is encoded at CritDamage.

Buff

{
  text: "Apply Buff/Condition",
  type: "Buff",
  icon: "url",
  duration: 5,
  status: "Vulnerability",
  description: "Damage and condition damage taken are increased; stacks intensity.",
  apply_count: 1
}

status (string) – The boon, condition, or effect referred to by the fact.
description (string, optional) – The description of the status effect.
apply_count (number, optional) – The number of stacks applied.
duration (number, optional) – The duration of the effect in seconds. Note that some facts of this type are just used to display the buff icon with text; in this case, duration is usually 0, or omitted entirely.

ComboField

{
  text: "Combo Field",
  type: "ComboField",
  field_type: "Ethereal"
}

field_type (string) – The type of field. One of: Air, Dark, Fire, Ice, Light, Lightning, Poison, Smoke, Ethereal, Water.

ComboFinisher

{
  text: "Combo Finisher",
  type: "ComboFinisher",
  percent: 100,
  finisher_type: "Blast"
}

finisher_type (string) – The type of finisher. One of: Blast, Leap, Projectile, Whirl.
percent (number) – The percent chance that the finisher will trigger.

Damage

{
  text: "Damage",
  type: "Damage",
  icon: "url",
  hit_count: 1,
  dmg_multiplier: 0.6
}

hit_count (number) – The amount of times the damage hits.
dmg_multiplier (number) - Indicates the damage multiplier value of that skill.

Distance

{
  text: "Radius",
  type: "Distance",
  icon: "url",
  distance: 180
}

distance (number) – The distance value.

Duration

{
  "text": "Venom Duration",
  "type": "Duration",
  "icon": "url",
  "duration": 30
}

duration (number) - The duration in seconds.

Heal

{
  "text": "Healing",
  "type": "Heal",
  "icon": "url",
  "hit_count": 1
}

hit_count (number) - The number of times the heal is applied.

HealingAdjust

{
  "text": "Healing",
  "type": "HealingAdjust",
  "icon": "url",
  "hit_count": 1
}

NoData

{
  text: "Combat Only",
  type: "NoData",
  icon: "url"
}

This fact is usually used to display the Combat Only fact, but it can be used elsewhere.

Number

{
  text: "Conditions Removed",
  type: "Number",
  icon: "url",
  value: 3
}

value (number) – The number value as referenced by text.

Percent

{
  text: "Health Threshold",
  type: "Percent",
  icon: "url",
  percent: 25
}

percent (number) – The percentage value as referenced by text.

PrefixedBuff

{
  text: "Apply Buff/Condition",
  type: "PrefixedBuff",
  icon: "url",
  duration: 20,
  status: "Might",
  description: "Increased outgoing damage; stacks intensity.",
  apply_count: 1,
  prefix: {
    text: "Apply Buff/Condition",
    icon: "url",
    status: "Fire Attunement",
    description: "Cast fire spells."
  }
}

This fact contains the same info as the buff fact, but includes an additional prefix object that describes the icon to show before the fact.

Radius

{
  text: "Radius",
  type: "Radius",
  icon: "url",
  distance: 180
}

distance (number) – The radius value.

Range

{
  text: "Range",
  type: "Range",
  value: 150
}

value (number) – The range of the trait/skill.

Recharge

{
  text: "Recharge",
  type: "Recharge",
  value: 40
}

value (number) – The recharge time in seconds.

StunBreak

{
  "text": "StunBreak",
  "type": "StunBreak",
  "icon": "https://render.guildwars2.com/file/DCF0719729165FD8910E034CA4E0780F90582D15/156654.png",
  "value": true
},

value (boolean) – Always true.

Time

{
  text: "Duration Increase",
  type: "Time",
  icon: "url",
  duration: 2
}

duration (number) – The time value in seconds.

Unblockable

{
  text: "Unblockable",
  type: "Unblockable",
  value: true
}

value (boolean) – Always true.

Example

https://api.guildwars2.com/v2/skills/14375

{
  "name": "Arcing Slice",
  "facts": [
    {
      "text": "Range",
      "type": "Range",
      "value": 150
    },
    {
      "text": "Recharge",
      "type": "Recharge",
      "value": 8
    },
    {
      "text": "Damage",
      "type": "Damage",
      "icon": "...",
      "hit_count": 1
    },
    {
      "text": "Damage against Foes under 50% Health",
      "type": "Damage",
      "icon": "...",
      "hit_count": 1
    },
    {
      "text": "Apply Buff/Condition",
      "type": "Buff",
      "icon": "...",
      "duration": 5,
      "status": "Fury",
      "description": "Critical Chance increased by 20%; stacks duration.",
      "apply_count": 1
    },
    {
      "text": "Number of Targets",
      "type": "Number",
      "icon": "...",
      "value": 5
    },
    ...
  ],
  "description": "Burst. Deliver a circular attack to foes around you, and gain fury. Deal more damage to foes with low health.",
  "type": "Profession",
  "weapon_type": "None",
  "professions": [
    "Warrior"
  ],
  "slot": "Profession_1",
  "cost": 30,
  "flip_skill": 14545,
  "categories": [
    "Burst"
  ],
  "traited_facts": [
    {
      "text": "Damage",
      "type": "Damage",
      "icon": "...",
      "requires_trait": 1657,
      "hit_count": 1,
      "overrides": 2
    },
    {
      "text": "Damage against Foes under 50% Health",
      "type": "Damage",
      "icon": "...",
      "requires_trait": 1657,
      "hit_count": 1,
      "overrides": 3
    }
  ],
  "icon": "...",
  "id": 14375,
  "chat_link": "[&Byc4AAA=]"
}

https://api.guildwars2.com/v2/skills?ids=5516,5517

[
  {
    name: "Conjure Fiery Greatsword",
    description: "Conjure. Manifest a fiery greatsword in your hands and at the target location. When it lands, it damages and burns foes. Wielders of this weapon gain increased power and condition damage.",
    type: "Elite",
    weapon_type: "None",
    professions: [
      "Elementalist"
    ],
    slot: "Elite",
    categories: [
      "Conjure"
    ],
    bundle_skills: [
      5532,
      5533,
      5697,
      5517,
      5531
    ],
    icon: "..",
    id: 5516
  },
  {
    name: "Fiery Rush",
    description: "Charge at your foe, leaving a line of fire behind you.",
    type: "Bundle",
    weapon_type: "None",
    professions: [
      "Thief",
      "Mesmer",
      "Warrior",
      "Elementalist",
      "Necromancer",
      "Guardian",
      "Ranger",
      "Engineer",
      "Revenant"
    ],
    slot: "Weapon_4",
    icon: "...",
    id: 5517
  }
]

Notes

API bugs:

Firebrand Tome skills are not whitelisted. (ref)
Thief raid stolen skills are not whitelisted. (ref)
Ranger pet skills are not whitelisted (ref)
The activation time fact is not exposed on skills with casting times displayed in the ingame tooltips. (ref)
All facts except Life Force Cost have the "type" field set. (ref)
Some trait-activated skills are missing their "type" value. (ref)