API:2/finishers
From Guild Wars 2 Wiki
< API:2
Jump to navigationJump to 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 specifiedid
when accessing the endpoint (v2/finishers/id
). Cannot be used when specifying theids
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 specifiedids
or all finishers. Cannot be used when accessing theid
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 itemids
used to unlock the finisher. Can be resolved against v2/itemsorder
(integer) (default/null value: 0) - The order in which the finisher appears in a list.icon
(string) (default/null value: "") - Theicon
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" } ]