API:2/titles

From Guild Wars 2 Wiki
Jump to: navigation, 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 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
   ]
 }