API:2/legends

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/legends

HTTP method
GET
Format
json
API version
version 2
Release date
2016-04-22
Scope
none
Optional
none

This resource returns information about the Revenant Legends that are in the game.

Endpoints

  • None - Request the list of all available Legend ids when the root endpoint (v2/legends) has been accessed.
  • id - (Optional) Request the Legend for the specificed id when accessing the endpoint (v2/legends/id). Cannot be used when specifying the ids parameter.

Parameters

  • lang – (Optional) Request localized information.
  • page - (Optional; integer)
  • page_size - (Optional; integer)
  • ids - (Optional; Comma Delimited List|all) Request an array of Legends for the specified ids or all Legends. Cannot be used when using the id endpoint.

Response

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

  • id (string) (default/null value: "") - The id of the Legend.
  • code (number) - The legend code for a build template link. Available on schema version 2019-12-19T00:00:00.000Z or later.
  • swap (integer) (default/null value: 0) - The id of the profession (swap Legend) skill resolvable against v2/skills.
  • heal (integer) (default/null value: 0) - The id of the heal skill resolvable against v2/skills.
  • elite (integer) (default/null value: 0) - The id of the elite skill resolvable against v2/skills.
  • utilities (array of integers) - List of ids of the utility skills resolvable against v2/skills.

Example

https://api.guildwars2.com/v2/legends

[
 "Legend1",
 "Legend2",
 "Legend3",
 "Legend4",
 "Legend6"
]

https://api.guildwars2.com/v2/legends/Legend2

{
 "id":"Legend2",
 "swap":27659,
 "heal":26937,
 "elite":28406,
 "utilities":[
  29209,
  28231,
  27107
 ]
}

https://api.guildwars2.com/v2/legends?ids=Legend4

[
 {
  "id":"Legend4",
  "swap":28376,
  "heal":28219,
  "elite":28287,
  "utilities":[
   27322,
   27505,
   27917
  ]
 }
]