API:2/titles

This resource returns information about the titles that are in the game.

Endpoints

None - Request the list of all available title ids.
id - (Optional) Request the title for the specified id when accessing the endpoint (v2/pvp/titles/id). Cannot be used when specifying the id or ids parameters.

Parameters

lang – (Optional) Request localized information.
page - (Optional; integer)
page_size - (Optional; integer)
id - (Optional) Request the title for the specified id. Cannot be used when specifying the id endpoint or ids parameter.
ids - (Optional; Comma Delimited List|all) Request an array of titles for the specified ids or all titles. Cannot be used when using the id endpoint or id parameter.

Response

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

id (integer) (default/null value: 0) - The id of the title.
name (string) (default/null value: "") - The name of the title (this is also the title displayed over a character in-game.)
achievement (integer) (default/null value: 0) (Now depreciated) - The id of the achievement that grants this title; resolvable against v2/achievements.
achievements (array of integers) - The id of the achievement that grants this title; resolvable against v2/achievements.
ap_required (number) - The amount of AP required to have said title.

Example

https://api.guildwars2.com/v2/titles

[
 1,
 2,
 3,
 ...,
 237,
 238,
 242
]

https://api.guildwars2.com/v2/titles/8

{
   "id": 8,
   "name": "Flameseeker",
   "achievement": 118,
   "achievements": [
       118
   ]
 }

https://api.guildwars2.com/v2/titles?id=10

 {
   "id": 10,
   "name": "Champion of the Gods",
   "achievement": 120,
   "achievements": [
       120
   ]
 }

https://api.guildwars2.com/v2/titles?ids=30

[
 {
   "id": 30,
   "name": "Yakslapper",
   "achievement": 288,
   "achievements": [
       288
   ]
 }
]

https://api.guildwars2.com/v2/titles?ids=40,90

 [
   {
       "id": 40,
       "name": "Kingmaker",
       "achievement": 294,
       "achievements": [
           294
       ]
   },
   {
       "id": 90,
       "name": "Slayer",
       "achievement": 239,
       "achievements": [
           239
       ]
   }
 ]

https://api.guildwars2.com/v2/titles?id=222&lang=es

 {
   "id": 222,
   "name": "El Niño Dorado",
   "achievement": 2622,
   "achievements": [
       2622
   ]
 }

Notes

API bug:

There are at least two titles that are not exposed by this endpoint, Crabgrabber (141) and Veteran of the Mists (176). These titles are however exposed from the characters endpoint. (ref)

API