API:2/finishers

From Guild Wars 2 Wiki
Jump to: navigation, search

/v2/finishers

HTTP method
GET
Format
json
API version
version 2
Release date
2016-05-24
Scope
none
Optional
none

This resource returns information about finishers that are available in-game.

Endpoints

  • None - Request the list of all available finisher ids when the root endpoint (v2/finishers) has been accessed.
  • id - (Optional) Request the finisher for the specified id when accessing the endpoint (v2/finishers/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 finishers for the specified ids or all finishers. Cannot be used when accessing the id endpoint.

Response

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

  • id (integer) (default/null value: 0) - The id of the finisher.
  • unlock_details (string) (default/null value: "") - A description explaining how to acquire the finisher.
  • unlock_items (array of numbers) (optional) - An array of item ids used to unlock the finisher. Can be resolved against v2/items
  • order (integer) (default/null value: 0) - The order in which the finisher appears in a list.
  • icon (string) (default/null value: "") - The icon uri for the finisher.
  • name (string) (default/null value: "") - The name of the finisher as it appears in-game.

Example

https://api.guildwars2.com/v2/finishers/1

{
 "id":1,
 "unlock_details":"<c=@reminder>Unlock this PvP rank finisher by earning rank points and increasing your PvP rank.</c>",
 "order":18,
 "icon":"https://render.guildwars2.com/file/807516C20D08B908946167EADD57980163EECA4E/620101.png",
 "name":"Rabbit Rank Finisher"
}

https://api.guildwars2.com/v2/finishers?ids=2

[
 {
  "id":2,
  "unlock_details":"<c=@reminder>Unlock this PvP rank finisher by earning rank points and increasing your PvP rank.</c>",
  "order":17,
  "icon":"https://render.guildwars2.com/file/6A68492F14AB3AFC5A95BCE008BDE8B50EB82CAF/620104.png",
  "name":"Deer Rank Finisher"
 }
]