API:2/pvp/ranks

From Guild Wars 2 Wiki
< API:2‎ | pvp
Jump to: navigation, 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 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
           }
       ]
   }
 ]