API:2/pvp/standings

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

/v2/pvp/standings

HTTP method
GET
Format
json
API version
version 2
Release date
2016-02-15
Scope
account
pvp
Optional
none

This resource returns information about player pips. This endpoint is only accessible with a valid API key.

Parameters

  • access_token (optional) – Can be used to specify an API key for the request if it is not given in a request header.

Response

  • current (array)
    • total_points (number)
    • division (number) – 0-indexed and refers to the data returned by season ID.
    • tier (number) – 0-indexed and refers to the data returned by season ID.
    • points (number)
    • repeats (number) – The number of times the account has maxed out the "Repeat" division.
    • rating (number)(for PvP season 5 and after only) - The current rating level.
    • decay (number)(for PvP season 5 and after only) - The current decay value.
  • best (array)
    • total_points (number)
    • division (number) – 0-indexed and refers to the data returned by season ID.
    • tier (number) – 0-indexed and refers to the data returned by season ID.
    • points (number)
    • repeats (number) – The number of times the account has maxed out the "Repeat" division.
  • season_id (string) – The season ID.

Example

Request

 https://api.guildwars2.com/v2/pvp/standings
 Authorization: Bearer <API key>

Response

{
 current : {
  total_points : 101,
  division     : 4,
  tier         : 1,
  points       : 1,
  repeats      : 0,
  rating       : 845,
  decay        : 100
 },
 best : {
  total_points : 200,
  division     : 5,
  tier         : 4,
  points       : 0,
  repeats      : 2
 },
 season_id : "44B85826-B5ED-4890-8C77-82DDF9F2CF2B"
}