API:2/account/achievements

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

/v2/account/achievements

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

This resource returns an account's progress towards all their achievements.

Parameters

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

Response

The response shows every achievement that the account has progress on by ID and how far the player has progressed. For each achievement, the following object is given:

  • id (number) – The achievement id.
  • bits (array, optional) – This attribute contains an array of numbers, giving more specific information on the progress for the achievement. The meaning of each value varies with each achievement. Bits start at zero. If an achievement is done, the in-progress bits are not displayed.
  • current (number, optional) – The player's current progress towards the achievement.
  • max (number, optional) – The amount needed to complete the achievement.
  • done (boolean) – Whether or not the achievement is done.
  • repeated (number, optional) – The number of times the achievement has been completed if the achievement is repeatable.
  • unlocked (boolean, optional) – Whether or not the achievement is unlocked. Note that if this property does not exist, the achievement is unlocked as well.

Example

Request

https://api.guildwars2.com/v2/account/achievements
Authorization: Bearer <API key>

Response

[
  {
    "id": 1,
    "current": 1,
    "max": 1000,
    "done": false
  },
  {
    "id": 202,
    "done": true
  },
  {
    "id": 1653,
    "bits": [ 
      2,
      3,
      4,
      5
    ],
    "current": 4,
    "max": 30,
    "done": false
  }
]