API:2/account/wizardsvault/listings

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/account/wizardsvault/listings

HTTP method
GET
Format
json
API version
version 2
Release date
2024-02-27
Scope
account
Optional
none

This resource returns the current set of Wizard's Vault rewards, along with details about which have already been purchased by the account, and in what quantity.

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

When requested, the endpoint will return an array of objects containing details about the rewards listed in the Wizards Vault.

Each object in the array contains the following properties

  • id (integer) – The listing id.
  • item_id - The id of the item
  • item_count (string) - The quantity of the item the user receives
  • type (enum) - Appears to be the position in the wizards vault UI. Possible values include "Featured" (In the hero banner at the top), "Normal" (Displayed in the rewards table) and "Legacy" (In the Legacy Vault section).
  • cost (integer) - The quantity of Astral Acclaim to purchase .
  • purchased (number) - Optional. Not included if the reward is unlimited (e.g. the unlimited Bag of Coins (1 Gold))
  • purchase_limit (number) - Optional. Not included if the reward is unlimited (e.g. the unlimited Bag of Coins (1 Gold))
  • The "purchased" field is always reported as 0 even when some items have been purchased from the vault.
  • The response from this api will not update until a character on the account has logged in during the current season.

Example

Request

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

Response

[
  {
    "id": 1,
    "item_id": 101574,
    "item_count": 1,
    "type": "Featured",
    "cost": 500,
    "purchased": 0,
    "purchase_limit": 1
  },
  {
    "id": 2,
    "item_id": 101617,
    "item_count": 1,
    "type": "Featured",
    "cost": 500,
    "purchased": 0,
    "purchase_limit": 1
  },
  {
    "id": 3,
    "item_id": 101485,
    "item_count": 1,
    "type": "Featured",
    "cost": 150,
    "purchased": 0,
    "purchase_limit": 16
  },
  {
    "id": 4,
    "item_id": 101533,
    "item_count": 1,
    "type": "Featured",
    "cost": 375,
    "purchased": 0,
    "purchase_limit": 1
  },
  {
    "id": 5,
    "item_id": 101469,
    "item_count": 1,
    "type": "Featured",
    "cost": 375,
    "purchased": 0,
    "purchase_limit": 1
  },
  {
    "id": 6,
    "item_id": 101475,
    "item_count": 1,
    "type": "Featured",
    "cost": 375,
    "purchased": 0,
    "purchase_limit": 1
  },
  {
    "id": 7,
    "item_id": 101623,
    "item_count": 1,
    "type": "Normal",
    "cost": 1000,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 8,
    "item_id": 100878,
    "item_count": 1,
    "type": "Normal",
    "cost": 6,
    "purchased": 0,
    "purchase_limit": 90
  },
  {
    "id": 9,
    "item_id": 100595,
    "item_count": 1,
    "type": "Normal",
    "cost": 35
  },
  {
    "id": 10,
    "item_id": 19976,
    "item_count": 1,
    "type": "Normal",
    "cost": 9,
    "purchased": 0,
    "purchase_limit": 60
  },
  {
    "id": 11,
    "item_id": 68314,
    "item_count": 1,
    "type": "Normal",
    "cost": 10,
    "purchased": 0,
    "purchase_limit": 150
  },
  {
    "id": 12,
    "item_id": 43766,
    "item_count": 1,
    "type": "Normal",
    "cost": 8,
    "purchased": 0,
    "purchase_limit": 35
  },
  {
    "id": 13,
    "item_id": 95289,
    "item_count": 1,
    "type": "Normal",
    "cost": 15,
    "purchased": 0,
    "purchase_limit": 20
  },
  {
    "id": 14,
    "item_id": 45176,
    "item_count": 1,
    "type": "Normal",
    "cost": 6,
    "purchased": 0,
    "purchase_limit": 40
  },
  {
    "id": 15,
    "item_id": 39124,
    "item_count": 1,
    "type": "Normal",
    "cost": 8,
    "purchased": 0,
    "purchase_limit": 30
  },
  {
    "id": 16,
    "item_id": 39123,
    "item_count": 1,
    "type": "Normal",
    "cost": 40
  },
  {
    "id": 17,
    "item_id": 100233,
    "item_count": 1,
    "type": "Normal",
    "cost": 1000,
    "purchased": 0,
    "purchase_limit": 2
  },
  {
    "id": 18,
    "item_id": 49208,
    "item_count": 1,
    "type": "Normal",
    "cost": 400,
    "purchased": 0,
    "purchase_limit": 3
  },
  {
    "id": 19,
    "item_id": 49207,
    "item_count": 1,
    "type": "Normal",
    "cost": 600,
    "purchased": 0,
    "purchase_limit": 1
  },
  {
    "id": 20,
    "item_id": 64737,
    "item_count": 1,
    "type": "Normal",
    "cost": 8,
    "purchased": 0,
    "purchase_limit": 30
  },
  {
    "id": 21,
    "item_id": 92206,
    "item_count": 1,
    "type": "Normal",
    "cost": 500,
    "purchased": 0,
    "purchase_limit": 1
  },
  {
    "id": 22,
    "item_id": 92209,
    "item_count": 1,
    "type": "Normal",
    "cost": 350,
    "purchased": 0,
    "purchase_limit": 2
  },
  {
    "id": 23,
    "item_id": 20349,
    "item_count": 1,
    "type": "Normal",
    "cost": 35,
    "purchased": 0,
    "purchase_limit": 12
  },
  {
    "id": 24,
    "item_id": 19996,
    "item_count": 1,
    "type": "Normal",
    "cost": 95,
    "purchased": 0,
    "purchase_limit": 10
  },
  {
    "id": 25,
    "item_id": 46746,
    "item_count": 1,
    "type": "Normal",
    "cost": 150,
    "purchased": 0,
    "purchase_limit": 4
  },
  {
    "id": 26,
    "item_id": 19925,
    "item_count": 1,
    "type": "Normal",
    "cost": 50,
    "purchased": 0,
    "purchase_limit": 20
  },
  {
    "id": 27,
    "item_id": 19675,
    "item_count": 1,
    "type": "Normal",
    "cost": 60,
    "purchased": 0,
    "purchase_limit": 20
  },
  {
    "id": 28,
    "item_id": 19986,
    "item_count": 1,
    "type": "Normal",
    "cost": 50,
    "purchased": 0,
    "purchase_limit": 3
  },
  {
    "id": 29,
    "item_id": 100663,
    "item_count": 1,
    "type": "Legacy",
    "cost": 1200,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 30,
    "item_id": 100099,
    "item_count": 1,
    "type": "Legacy",
    "cost": 300,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 31,
    "item_id": 100284,
    "item_count": 1,
    "type": "Legacy",
    "cost": 180,
    "purchased": 9,
    "purchase_limit": 16
  },
  {
    "id": 32,
    "item_id": 100593,
    "item_count": 1,
    "type": "Legacy",
    "cost": 450,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 33,
    "item_id": 100361,
    "item_count": 1,
    "type": "Legacy",
    "cost": 450,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 34,
    "item_id": 100029,
    "item_count": 1,
    "type": "Legacy",
    "cost": 450,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 35,
    "item_id": 101199,
    "item_count": 1,
    "type": "Legacy",
    "cost": 450,
    "purchased": 0,
    "purchase_limit": 1
  },
  {
    "id": 36,
    "item_id": 101227,
    "item_count": 1,
    "type": "Legacy",
    "cost": 180,
    "purchased": 0,
    "purchase_limit": 16
  },
  {
    "id": 37,
    "item_id": 100401,
    "item_count": 1,
    "type": "Legacy",
    "cost": 450,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 38,
    "item_id": 100172,
    "item_count": 1,
    "type": "Legacy",
    "cost": 450,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 39,
    "item_id": 100449,
    "item_count": 1,
    "type": "Legacy",
    "cost": 450,
    "purchased": 1,
    "purchase_limit": 1
  },
  {
    "id": 40,
    "item_id": 101205,
    "item_count": 1,
    "type": "Legacy",
    "cost": 450,
    "purchased": 1,
    "purchase_limit": 1
  }
]