API:2/skills

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/skills

HTTP method
GET
Format
json
API version
version 2
Release date
2015-12-16
Scope
none
Optional
none

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, optional) – Used to indicate that the skill will transform the player, replacing their skills with the skills listed in the array.
  • bundle_skills (array, 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.

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

  • 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)