API:2/account

From Guild Wars 2 Wiki
Jump to: navigation, search

/v2/account

HTTP method
GET
Format
json
API version
version 2
Release date
2015-02-24
Scope
account
Optional
progression

This resource returns information about player accounts. This endpoint is only accessible with a valid API key.

Parameters

  • access_token (optional) – Can be used to specify an API key for the request if it is not given in the request header.

Response

  • id (string) – The unique persistent account GUID.
  • age (number) - The age of the account in seconds.
  • name (string) – The unique account name with numerical suffix. It is possible that the name change. Do not rely on the name, use id instead.[1]
  • world (number) – The id of the home world the account is assigned to. Can be resolved against /v2/worlds.
  • guilds (array) – A list of guilds assigned to the given account.
  • guild_leader (array) – A list of guilds the account is leader of.
  • created (string) – An ISO-8601 standard timestamp of when the account was created.
  • access (array) – A list of what content this account has access to. Possible values:
    • None – should probably never happen
    • PlayForFree – has not yet purchased the game
    • GuildWars2 – has purchased the base game
    • HeartOfThorns – has purchased Heart of Thorns
    • PathOfFire – has purchased Path of Fire
  • commander (boolean) – True if the player has bought a commander tag.
  • fractal_level (number) – The account's personal fractal reward level. Requires the additional progression scope.
  • daily_ap (number) – The daily AP the account has. Requires the additional progression scope.
  • monthly_ap (number) – The monthly AP the account has. Requires the additional progression scope.
  • wvw_rank (number) – The account's personal wvw rank. Requires the additional progression scope.

Example

Request

https://api.guildwars2.com/v2/account
Authorization: Bearer <API key>

Response

{
  "id": "C19467C6-F5AD-E211-8756-78E7D1936222",
  "name": "Account.1234",
  "age": 22911780,
  "world": 1004,
  "guilds": [
    "116E0C0E-0035-44A9-BB22-4AE3E23127E5",
    "5AE2FE0C-79B2-4AA9-8A03-80CBE3A3740D",
    "A0F09951-FBA2-492E-8888-C449C217ECAD",
    "8977C915-D948-E511-8D0D-AC162DAE8ACD",
    "032AAA16-749B-E311-A32A-E4115BDFA895"
  ],
  "guild_leader": [
    "032AAA16-749B-E311-A32A-E4115BDFA895"
  ],
  "created": "2013-04-25T22:09:00Z",
  "access": [
    "GuildWars2",
    "HeartOfThorns",
    "PathOfFire"
  ],
  "commander": true,
  "fractal_level": 100,
  "daily_ap": 7659,
  "monthly_ap": 1129,
  "wvw_rank": 514
}

References