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 id, an object with the following properties is returned:

id (integer) – The id of the title.
name (string) – The name of the title (this is also the title displayed over a character in-game.)
achievement (integer) (deprecated, use achievements instead) – 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, optional) – The amount of AP required to get the 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