API:2/mapchests

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/mapchests

HTTP method
GET
Format
json
API version
version 2
Release date
2019-04-06
Scope
none
Optional
none

This resource returns information about Hero's Choice Chests that can be be acquired once a day in-game.

Endpoints

  • None - Request the list of all available map chest ids.
  • id - (Optional) Request the map chest for the specified id. Cannot be used when specifying the ids parameter.

Parameters

  • ids - (Optional; Comma Delimited List|all) Request an array of map chests for the specified ids or all such map chests. Cannot be used when accessing the id endpoint.

Response

For each requested map chest id, an object with the following properties is returned:

  • id (string) - The (API-specific) id of the map chest.

Example

https://api.guildwars2.com/v2/mapchests

[
  "auric_basin_heros_choice_chest",
  "crystal_oasis_heros_choice_chest",
  "domain_of_vabbi_heros_choice_chest",
  "dragons_stand_heros_choice_chest",
  "elon_riverlands_heros_choice_chest",
  "tangled_depths_heros_choice_chest",
  "the_desolation_heros_choice_chest",
  "verdant_brink_heros_choice_chest"
]

https://api.guildwars2.com/v2/mapchests/auric_basin_heros_choice_chest

{
  "id": "auric_basin_heros_choice_chest"
}

https://api.guildwars2.com/v2/mapchests?ids=tangled_depths_heros_choice_chest,auric_basin_heros_choice_chest

[
  {
    "id": "tangled_depths_heros_choice_chest"
  },
  {
    "id": "auric_basin_heros_choice_chest"
  }
]