API:2/titles

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/titles

HTTP method
GET
Format
json
API version
version 2
Release date
2016-04-12
Scope
none
Optional
none

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

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)