API:2/achievements/categories

From Guild Wars 2 Wiki
Jump to: navigation, search

/v2/achievements/categories

HTTP method
GET
Format
json
API version
version 2
Release date
2015-12-02
Scope
none
Optional
none

This resource returns all the categories for achievements.

Parameters

  • lang (optional) – The language to query for.

Response

If the root endpoint (/v2/achievements/categories) is accessed without specifying an id, a list of all ids is returned. When multiple ids are requested using the ids parameter, a list of response objects is returned.

For each requested category id, an object with the following properties is returned:

  • id (number) - The category's ID.
  • name (string) – The category name.
  • description (string) – The category description.
  • order (number) – A number describing where to sort this category among other the other categories in its group. Lowest numbers go first, highest numbers go last.
  • icon (string) – A URL to an image for the icon of the category.
  • achievements (array) – An array containing a number of achievement IDs that this category contains. (See /v2/achievements.)

Example

https://api.guildwars2.com/v2/achievements/categories/1
{
  "id": 1,
  "name": "Slayer",
  "description": "",
  "order": 30,
  "icon": "https://render.guildwars2.com/file/E00460A2CAD85D47406EAB4213D1010B3E80C9B0/42675.png",
  "achievements": [1, 5, 4, 6, ...] 
}