API:2/pvp/heroes
From Guild Wars 2 Wiki
Jump to navigationJump to search
/v2/pvp/heroes
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2017-04-19
- Scope
- none
- Optional
- none
This resource returns information about pvp heroess that are available in-game.
Endpoints
- None - Request the list of all available pvp heroes
ids
when the root endpoint (v2/pvp/heroes
) has been accessed. id
- (Optional) Request the pvp heroes for the specifiedid
when accessing the endpoint (v2/pvp/heroes/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 pvp heroess for the specifiedids
or all pvp heroess. Cannot be used when accessing theid
endpoint.
Response
For each requested pvp heroes id
, an object with the following properties is returned:
id
(string) - The id of the pvp heroes.name
(string) - The name of the pvp heroes.type
(string) - The flavor type describing the herostats
(object) - An object reflecting the champions stats underoffense
,defense
, orspeed
.overlay
(string) - The overlay art url for that champion.underlay
(string) - The underlay art url for that champion.skins
(array of objects)id
(number) - The skin idname
(string) - The name of the skinicon
(string) - The icon url for the skindefault
(boolean) - States if the skin is the default champion skin.unlock_items
(array of numbers) - Item ids which unlock the skin. Can be resolved against v2/items.
Example
https://api.guildwars2.com/v2/pvp/heroes/115C140F-C2F5-40EB-8EA2-C3773F2AE468
{ "id": "115C140F-C2F5-40EB-8EA2-C3773F2AE468", "name": "Nika", "description": "Nika was a proficient assassin schooled in her youth at Shing Jea Monastery. She served Cantha as a member of the Obsidian Flame.", "type": "Specialist Hero", "stats": { "offense": 3, "defense": 2, "speed": 4 }, "overlay": "https://render.guildwars2.com/file/2CACF4120E370D1997A4C3D69BF592D7CC1870C8/993693.png", "underlay": "https://render.guildwars2.com/file/103108E0D8EDD22C577FA4171618D004A82AD955/993694.png", "skins": [ { "id": 1, "name": "Nika", "icon": "https://render.guildwars2.com/file/4602BDC15B73422011AC664425D93750707F04F3/1058576.png", "default": true }, { "id": 7, "name": "Shadow Assassin Nika", "icon": "https://render.guildwars2.com/file/01643F1BD1202007BEE8E37F7DA3EA31AEE9536C/1322841.png", "default": false }, ... ] }