API:2/account/mastery/points

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

/v2/account/mastery/points

HTTP method
GET
Format
json
API version
version 2
Release date
2016-06-14
Scope
account
progression
Optional
none

This resource returns information about the total amount of masteries that are unlocked for an account. A detailed mastery track completion break down is available at /v2/account/masteries.

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

This request will return an object with the following properties:

  • totals (array of objects)
    • region (string) – The mastery region. Current possible options: Tyria, Maguuma, Desert.
    • spent (number) – Amount of masteries of this region spent in mastery tracks.
    • earned (number) – Amount of masteries of this region earned for the account.
  • unlocked (array of numbers) – Array of mastery ids.

Example

Request

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

Response

{
  "totals": [
    {
      "region": "Tyria",
      "spent": 49,
      "earned": 63
    },
    {
      "region": "Maguuma",
      "spent": 137,
      "earned": 175
    },
    {
      "region": "Desert",
      "spent": 76,
      "earned": 84
    }
  ],
  "unlocked": [
    1,
    305
  ]
}

Notes

  • Mastery points from certain achievements (Transfer Chaser, Nightmare Fractal) are not displayed by this endpoint. (ref)
  • Mastery points for achievements which are not whitelisted can also be displayed (such as 494 and 535).
  • Most mastery points are awarded by achievements, and as such can be mapped against the mastery rewards listed in API:2/achievements. The exception to this is Defeat Mayatl the Fierce which is not tracked with an achievement but awards mastery point 126.