API:2/account
From Guild Wars 2 Wiki
< API:2
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 additionalguilds
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 happenPlayForFree
– 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 gameHeartOfThorns
– 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 DragonsSecretsOfTheObscure
- has purchased Secrets of the ObscureJanthirWilds
- 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 additionalprogression
scope.daily_ap
(number) – The daily AP the account has. Requires the additionalprogression
scope.monthly_ap
(number) – The monthly AP the account has. Requires the additionalprogression
scope.wvw_rank
(number) – The account's personal wvw rank. Requires the additionalprogression
scope. This field is only present when a Schema version earlier than2024-07-20T01:00:00.000Z
is requested.wvw
(object) - This field is only present when a Schema version of2019-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 additionalprogression
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 of2019-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 additionalbuilds
scope. This field is only present when a Schema version of2019-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 }