API:2/pvp/ranks
From Guild Wars 2 Wiki
Jump to navigationJump to search
/v2/pvp/ranks
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2016-09-26
- Scope
- none
- Optional
- none
This resource returns information about the available ranks in the Player versus Player game mode.
Endpoints
- None - Request the list of all available pvp ranks
ids. id- (Optional) Request the pvp rank for the specifiedid. Cannot be used when specifying theidsparameter.
Parameters
lang– (Optional) Request localized information.ids- (Optional; Comma Delimited List|all) Request an array of Pvp ranks for the specifiedidsor all Pvp ranks. Cannot be used when accessing theidendpoint.
Response
For each requested pvp rank id, an object with the following properties is returned:
id(integer) (default/null value: 0) - The id of the pvp rank.finisher_id(integer) (default/null value: 0) - The id of the unlocked finisher, can be resolved against /v2/finishersname(string) (default/null value: "") - The given name for the PvP rank.icon(string) (default/null value: "") - Theiconuri for the Pvp rank.min_rank(integer) (default/null value: 0) - The minimum PvP level required to be at this rank.max_rank(integer) (default/null value: 0) - The maximum PvP level required to be at this rank.levels(array) -min_rank(integer) (default/null value: 0) - The minimum PvP level required to be at this rank.max_rank(integer) (default/null value: 0) - The maximum PvP level required to be at this rank.points(integer) (default/null value: 0) - The amount of PvP experience needed to go from the given minimum rank to maximum rank.
Example
https://api.guildwars2.com/v2/pvp/ranks
[ 1, 2, ..., 8, 9 ]
https://api.guildwars2.com/v2/pvp/ranks/2
{
"id": 2,
"finisher_id": 2,
"name": "Deer",
"icon": "https://render.guildwars2.com/file/DECD0D647C9433CC2128BF2F6FE5A5185513EE59/347223.png",
"min_rank": 10,
"max_rank": 19,
"levels": [
{
"min_rank": 10,
"max_rank": 19,
"points": 4000
}
]
}
https://api.guildwars2.com/v2/pvp/ranks?ids=2,4&lang=fr
[
{
"id": 2,
"finisher_id": 2,
"name": "Daim",
"icon": "https://render.guildwars2.com/file/DECD0D647C9433CC2128BF2F6FE5A5185513EE59/347223.png",
"min_rank": 10,
"max_rank": 19,
"levels": [
{
"min_rank": 10,
"max_rank": 19,
"points": 4000
}
]
},
{
"id": 4,
"finisher_id": 4,
"name": "Loup",
"icon": "https://render.guildwars2.com/file/B0920D9F3A07276854FDC4CD364AD3DDF6387061/347225.png",
"min_rank": 30,
"max_rank": 39,
"levels": [
{
"min_rank": 30,
"max_rank": 39,
"points": 15000
}
]
}
]
