API:2/homestead/decorations

/v2/homestead/decorations

HTTP method

GET

Format

json

API version

version 2

Release date

2024-08-23

Scope

none

Optional

none

This resource returns information about all available homestead decorations.

Endpoints

• None - Request the list of all available homestead decorations ids when the root endpoint (v2/homestead/decorations) has been accessed.
• id - (Optional) Request the homestead decoration for the specified id when accessing the endpoint (v2/homestead/decorations/id). Cannot be used when specifying the ids parameter.

Parameters

• lang – (Optional) Request localized content.
• page - (Optional; integer)
• page_size - (Optional; integer)
• ids - (Optional; Comma Delimited List) Request an array of homestead decorations for the specified ids. Cannot be used when accessing the id endpoint.

Response

For each requested homestead decoration id, an object with the following properties is returned:

• id (number) – The decoration id.
• name (string) – The name of the decoration.
• description (string) – The homestead decoration description.
• max_count (number) - The maximum amount of storable instances of this decoration.
• icon (string) – A URL pointing to an icon for the decoration.
• categories (array) – An array of decoration category ids which this decoration belongs to. Can be compared to the /homestead/decorations/categories endpoint

Example

https://api.guildwars2.com/v2/homestead/decorations/140

{
   "id": 140,
   "name": "Sandstone Pillar",
   "description": "Crafted by scribes.",
   "categories": [
     16,
     1
   ],
   "max_count": 250,
   "icon": "https://render.guildwars2.com/file/A2DBDD1E546A2F5EDAC301BA07FEA20F1B1C12A7/1223799.png"
 }

---

API

Account

achievements • bank • build storage • daily crafting • dungeons • dyes • finishers • gliders • home instance (cats • nodes) • homestead (decorations • glyphs) • legendary armory • luck • mail carriers • map chests • masteries • mastery/points • materials • minis • mounts (types • skins) • novelties • outfits • progression • PvP heroes • raids • recipes • shared inventory • jade bots • skiffs • skins • titles • wallet • wizard's vault (listings • daily • weekly • special) • world bosses

Achievements

achievements • categories • daily (tomorrow) • groups

Characters

backstory • build tabs • core • crafting • equipment • equipment tabs • hero points • inventory • quests • recipes • Super Adventure Box • skills • specializations • training

Daily Rewards

daily crafting • map chests • world bosses

Events

event details^v1

Game mechanics

colors • currencies • dungeons • emotes • legends • legendary armory • masteries • pets • professions • races • raids • skills • specializations • titles • traits

Guild

emblem (backgrounds • foregrounds) • info (log • members • ranks • stash • storage • teams • treasury • upgrades) • permissions • search • upgrades

Home instance

cats • nodes

Homestead

decorations • categories • glyphs

Items

items • item stats • materials • recipes (search)

Maps

continents • maps

Story

backstory (answers • questions) • quests • stories (seasons)

Structured PvP

amulets • games • heroes • ranks • seasons (leaderboards) • standings • stats

Commerce (Trading post)

delivery • exchange • listings • prices • transactions

Wardrobe

finishers • gliders • jade bots • mail carriers • minis • mounts (skins • types) • novelties • outfits • skiffs • skins

Wizard's Vault

listings • objectives

World vs. World

abilities • matches (guild stats • match stats • overview • scores ^[?] • team stats) • objectives • ranks • upgrades • worlds

Miscellaneous

build • create subtoken • files • quaggans • token info

Additional services

assets • render • tiles

Help topics

Best practices • Maps • Mumble Link