API:2/characters/:id/skills

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/characters/:id/skills

HTTP method
GET
Format
json
API version
version 2
Release date
2015-05-22
Scope
account
builds
characters
Optional
none

This resource returns information about the skills equipped 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

  • skills (object) - contains the pve, pvp, and wvw objects for the current utilities equipped.
    • pve (object) - contains the information on each slotted utility for PvE
      • heal (integer) - contains the skill id for the heal skill, resolvable against /v2/skills.
      • utilities (array of integers) - each integer corresponds to a skill id for the equipped utilities, resolvable against /v2/skills.
      • elite (integer) - contains the skill id for the elite skill, resolvable against /v2/skills.
      • legends (array of strings) (Revenant only) - each string corresponds to a Revenant legend, resolvable against /v2/legends.
    • pvp (object) - contains the information on each slotted utility for PvP
      • heal (integer) - contains the skill id for the heal skill, resolvable against /v2/skills.
      • utilities (array of integers) - each integer corresponds to a skill id for the equipped utilities, resolvable against /v2/skills.
      • elite (integer) - contains the skill id for the elite skill, resolvable against /v2/skills.
      • legends (array of strings) (Revenant only) - each string corresponds to a Revenant legend, resolvable against /v2/legends.
    • wvw (object) - contains the information on each slotted utility for WvW
      • heal (integer) - contains the skill id for the heal skill, resolvable against /v2/skills.
      • utilities (array of integers) - each integer corresponds to a skill id for the equipped utilities, resolvable against /v2/skills.
      • elite (integer) - contains the skill id for the elite skill, resolvable against /v2/skills.
      • legends (array of strings) (Revenant only) - each string corresponds to a Revenant legend, resolvable against /v2/legends.

Example

Request

  https://api.guildwars2.com/v2/characters/<character name>/skills
  Authorization: Bearer <API key>

  https://api.guildwars2.com/v2/characters/<character name>/skills?access_token=<API key>

Response

 {
   "skills": {
       "pve": {
           "heal": 29535,
           "utilities": [
               5734,
               5567,
               5542
           ],
           "elite": 29968
       },
       "pvp": {
           "heal": 29535,
           "utilities": [
               30432,
               30662,
               29948
           ],
           "elite": 29968
       },
       "wvw": {
           "heal": 29535,
           "utilities": [
               5734,
               5536,
               5542
           ],
           "elite": 29968
       }
   }
 }