API:2/account/achievements
From Guild Wars 2 Wiki
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 } ]