API talk:2/achievements

2015-12-10

• "tiers" (array of objects)
  • "count" (number) — The number of <things> needed to reach this tier.
  • "points" (number) — The non-cumulative AP awarded for reaching the tier.
• "rewards" (optional, array of objects) — Possible values below:

Item

• "type" (string) — Always "Item".
• "id" (number) — The rewarded item ID.
• "count" (number) — The rewarded item quantity.

Mastery

• "type" (string) — Always "Mastery".
• "region" (string) — the mastery point region. Possible valuess:
  • "Maguuma" (string) — Heart of Maguuma mastery point.
  • "Tyria" (string) — Central Tyria mastery point.

Example

https://api.guildwars2.com/v2/achievements?ids=910,1840

[
  {
    "id": 910,
    "name": "Tequatl the Sunless",
    "description": "",
    "requirement": "Complete  Tequatl achievements.",
    "type": "Default",
    "flags": [ "CategoryDisplay" ],
    "tiers": [
      { "count": 10, "points": 50 }
    ],
    "rewards": [
      { "type": "Mastery", "region": "Tyria" }
    ]
  },
  {
    "id": 1840,
    "name": "Daily Completionist",
    "description": "",
    "requirement": "Complete any  PvE, WvW, or PvP Daily Achievements.",
    "type": "Default",
    "flags": [ "Pvp", "CategoryDisplay" ],
    "tiers": [
      { "count": 3, "points": 10 }
    ],
    "rewards": [
      { "type": "Item", "id": 70047, "count": 1 }
    ]
  }
]

--BryghtShadow (talk) 21:32, 10 December 2015 (UTC)

This edit slightly misrepresents the rewards subobject structure.

• When type is Mastery, id and count doesn't exist.
• Likewise when type is Item, region doesn't exist.

While the achievements reward subobject structure is not as complex as v2/items, it has mandatory fields that are only present depending on its type. This article could do with a few more example responses as well. --BryghtShadow (talk) 07:11, 14 December 2015 (UTC)

I had thought my description of the fields was good enough, but I suppose I can see how it could be misunderstood. Threw in a couple examples, too. Eearslya (talk) 08:02, 14 December 2015 (UTC)

Change "MiniPet" to "Minipet"

API uses Minipet. --BryghtShadow (talk) 11:16, 14 December 2015 (UTC)

2016-09-13

• "locked_text" (string) - The text for locked achievements. Empty if nothing. (e.g. https://api.guildwars2.com/v2/achievements/3098 "Open the Primordus Weapon Crate.")
• "flags":
  • "Hidden" - Hidden achievements (e.g. https://api.guildwars2.com/v2/achievements/3099)
  • "RequiresUnlock" - Requires an item to unlock (e.g. https://api.guildwars2.com/v2/achievements/1710 Brewmaster)

--BryghtShadow (talk) 11:46, 13 September 2016 (UTC)

Mastery point reward objects have an id (number) - the id of the mastery point (no endpoint). The ID may be present on multiple achievements, such as the personal story achievements. These mastery point ids are shared:

• 208 reward for: Crime and Punishment / Graduation Day / Rising to the Challenge / For the Legion! / Waking from the Nightmare (https://api.guildwars2.com/v2/achievements?ids=64,65,66,67,68)
• 217 reward for: Something Lost, Something Gained / From Howl to Silence / Storming the Castle / Brawn over Brains / Branching Out (https://api.guildwars2.com/v2/achievements?ids=74,75,76,77,78)
• 235 reward for: Some Must Fight, That All May be Free / To Know the Unknown / Defending History, Informing the Future (https://api.guildwars2.com/v2/achievements?ids=79,98,99)
• 249 reward for: A Season of Growth / Legacy Code / Bloodying the Past / Family Reunion / Things Best Left Behind (https://api.guildwars2.com/v2/achievements?ids=69,70,71,72,73)

--BryghtShadow (talk) 09:05, 21 September 2016 (UTC)

2016-12-07

• "flags":
  • "RepairOnLogin" - Does anybody know what this flag means? I suspect it's applied to all Collection achievements to indicate that validation is done on every login to evaluate if the account should actually have credit for individual items in each collection.

-- Floodbars (talk) 06:45, 8 December 2016 (UTC)

Tundra Mastery

Tundra is missing in the possible values of rewards.Mastery.region. --Pandraghon (talk) 00:21, 7 November 2020 (UTC)

Added the value to the list, thanks —Kvothe (talk) 01:23, 7 November 2020 (UTC)

Missing Achievements

After looking through the APIs and in game, the API does not actually return a list of *all* achievements. I can't edit the page, but the text saying "This resource returns all achievements" is false. As examples: Achievement ids 5066 nor 5549 do not appear in the API, but are still present in game (see Skyscale Toy Training and Shimmering Aurora Weapon Collection respectively). Is there any way to modify the page to state that not all ids are returned and instead "most" ids are returned? --Thecaligarmo (talk) 16:52, 2 January 2021 (UTC)

Stuff not being whitelisted affects all endpoints tbh, I have however added a caveat to the first sentence. Other endpoints I can think of are firebrand tome skills in v2/skills, discontinued stat selectable fotm items, and until recently novelties. -Chieftain Alex 17:52, 3 January 2021 (UTC)