API:2/characters/:id/core

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/characters/:id/core

HTTP method
GET
Format
json
API version
version 2
Release date
2015-05-22
Scope
account
characters
Optional
none

This resource returns core information about a character attached to a specific account.

Parameters

  • access_token - (optional) If the API key is not specified in the request header, it can be specified here.

Response

  • name (string) - The character's name.
  • race (string) - The character's race. Possible values:
    • Asura
    • Charr
    • Human
    • Norn
    • Sylvari
  • gender (string) - The character's gender. Possible values:
    • Male
    • Female
  • profession (string) - The character's profession. Possible values:
    • Elementalist
    • Engineer
    • Guardian
    • Mesmer
    • Necromancer
    • Ranger
    • Revenant
    • Thief
    • Warrior
  • level (integer) - The character's level.
  • guild (string, optional) - The guild ID of the character's currently represented guild.
  • age (integer) - The amount of seconds this character was played.
  • last_modified (string) – An ISO-8601 standard timestamp of when the account information last changed as perceived by the API. This field is only present when a Schema version of 2019-02-21T00:00:00Z or later is requested.[1]
  • created (string) - ISO 8601 representation of the character's creation time.
  • deaths (integer) - The amount of times this character has been defeated.
  • title (number, optional) - The currently selected title for the character. References /v2/titles.

Example

Request

  https://api.guildwars2.com/v2/characters/<character name>/core
  Authorization: Bearer <API key>

  https://api.guildwars2.com/v2/characters/<character name>/core?access_token=<API key>

Response

 {
   "name": "<character name>",
   "race": "Asura",
   "gender": "Male",
   "profession": "Elementalist",
   "level": 80,
   "guild": "<guild id>",
   "age": 12631700,
   "created": "2013-04-27T04:15:00Z",
   "deaths": 9193,
   "title": 251
 }