API:2/account

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/account

HTTP method
GET
Format
json
API version
version 2
Release date
2015-02-24
Scope
account
Optional
guilds
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.
  • v (optional) - Can be used to specify the schema version.

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. Requires the additional guilds scope.
  • 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 – without any other flags, this identifies an account which has not yet purchased the game. (This flag does however also appear on accounts who have purchased the base game or any of the expansions).
    • GuildWars2 – has purchased the base game
    • HeartOfThorns – has purchased Heart of Thorns, accounts that recieve Heart of Thorns by purchasing Path of Fire will not have this flag set.
    • PathOfFire – has purchased Path of Fire, this flag also implies that the account has access to Heart of Thorns.
    • EndOfDragons - has purchased End of Dragons
    • SecretsOfTheObscure - has purchased Secrets of the Obscure
    • JanthirWilds - has purchased Janthir Wilds
  • commander (boolean) – True if the player has bought a Commander's Compendium. A player buying a Catmander's Compendium does not affect this flag.[2]
  • 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. This field is only present when a Schema version earlier than 2024-07-20T01:00:00.000Z is requested.
  • wvw (object) - This field is only present when a Schema version of 2019-02-21T00:00:00Z or later is requested.
    • team_id (number) - The currently allocated wvw world restructuring team id.
    • rank (number) - The account's personal wvw rank. Requires the additional progression scope.
  • 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.[3]
  • build_storage_slots (number) - The amount of build storage slot an account has unlocked. Requires the additional builds scope. This field is only present when a Schema version of 2019-12-19T00:00:00.000Z or later is requested.

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