API talk:2/pvp/standings

From Guild Wars 2 Wiki
Jump to navigationJump to search
{{API endpoint infobox
| endpoint = /v2/pvp/standings
| version = 2
| release = 2015-09-03
| scope = pvp
}}
This resource returns information about your best, current or final standings of the seasons in PvP.

== Parameters ==
* <code>access_token</code> - (optional) If the API key is not specified in the request header, it can be specified here.

== Response ==
* <code>current</code> (object) - Contains information of your current standings or final standings if season has ended.
* <code>best</code> (object) - Contains information of your best standings in a season.
* <code>total_points</code> (number) - The player's total points (ie. overall collected pips).
* <code>division</code> (number) - The player's division.
* <code>tier</code> (number) - The player's tier.
* <code>points</code> (number) - The player's points (ie. pips in the tier above).
* <code>repeats</code> (number) - Total amount of division repeats (prestige). Only relevant for the last division, which is legendary.
* <code>season_id</code> (string) - A seasons unique identifier.

== Example ==
=== Request ===
  https://api.guildwars2.com/v2/pvp/standings
  Authorization: Bearer <access token>

=== Response ===
 [{
       "current":{
             "total_points":109,
             "division":4,
             "tier":3,
             "points":4,
             "repeats":0
       },
       "best":{
             "total_points":113,
             "division":4,
             "tier":4,
             "points":3,
             "repeats":0
       },
       "season_id":"95D5B290-798A-421E-A919-1C2A75F74B72"
 }]

=== Season Identifiers ===
* <code>44B85826-B5ED-4890-8C77-82DDF9F2CF2B</code> - Season 1
* <code>95D5B290-798A-421E-A919-1C2A75F74B72</code> - Season 2

[[Category: Authenticated endpoint]]
The preceding unsigned comment was added by Nekres (talk) at 14:29, 14 April 2016‎ (UTC).