API:2/characters/:id/core
From Guild Wars 2 Wiki
< API:2 | characters
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 of2019-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 }