API:2/pvp/stats
From Guild Wars 2 Wiki
Jump to navigationJump to 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
}
}
}
