API:2/pvp/ranks

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 specified id. Cannot be used when specifying the ids parameter.

Parameters

lang – (Optional) Request localized information.
ids - (Optional; Comma Delimited List|all) Request an array of Pvp ranks for the specified ids or all Pvp ranks. Cannot be used when accessing the id endpoint.

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/finishers
name (string) (default/null value: "") - The given name for the PvP rank.
icon (string) (default/null value: "") - The icon uri 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
           }
       ]
   }
 ]

API