API:2/pvp/stats

From Guild Wars 2 Wiki
< API:2‎ | pvp
Jump to: navigation, search

/v2/pvp/stats

HTTP method
GET
Format
json
API version
version 2
Release date
2015-09-03
Scope
account
pvp
Optional
none

This resource returns information about wins and losses in the account's PvP matches.

Parameters

  • access_token - (optional) If the API key is not specified in the request header, it can be specified here.

Response

  • pvp_rank (number) - The player's PvP rank.
  • pvp_rank_points (number) - The player's PvP rank points.
  • pvp_rank_rollovers (number) - The number of times the player has levelled up since reaching rank 80. If they aren't rank 80 yet, it should be 0.
  • aggregate (object) - A win/loss object (see below) containing stats from all matches ever played.
  • professions (object) - Contains a subobject for each profession played in PvP, following the format of the win/loss object.
  • ladders (object) - Contains a subobject for each type of ladder (i.e. ranked, unranked), each containing a win/loss object.

Win/Loss Object

Each object labeled as a win/loss object contains the following properties:

  • wins (number) - The wins for the category.
  • losses (number) - The losses for the category.
  • desertions (number) - The desertions for the category.
  • byes (number) - The byes for the category.
  • forfeits (number) - The forfeit for the category.

Example

Request

 https://api.guildwars2.com/v2/pvp/stats
 Authorization: Bearer <access token>

Response

{
  "pvp_rank": 5,
  "pvp_rank_points": 6513,
  "pvp_rank_rollovers": 4,
  "aggregate": {
    "wins": 6,
    "losses": 14,
    "desertions": 0,
    "byes": 0,
    "forfeits": 0
  },
  "professions": {
    "elementalist": {
      "wins": 3,
      "losses": 7,
      "desertions": 0,
      "byes": 0,
      "forfeits": 0
    },
    "guardian": {
      "wins": 3,
      "losses": 7,
      "desertions": 0,
      "byes": 0,
      "forfeits": 0
    }
  },
  "ladders": {
    "ranked": {
      "wins": 4,
      "losses": 10,
      "desertions": 0,
      "byes": 0,
      "forfeits": 0
    },
    "unranked": {
      "wins": 2,
      "losses": 4,
      "desertions": 0,
      "byes": 0,
      "forfeits": 0
    }
  }
}