---
title: "The single-path category taxonomy for every asset type, plus the attribute schema."
method: GET
path: "/taxonomy"
tags: ["assets"]
---

# The single-path category taxonomy for every asset type, plus the attribute schema.

`GET /taxonomy`

Each asset belongs to exactly **one** category, given as a path such as `Coast & Water/Beaches/Sandy Beaches` (the asset's `category` field). This endpoint returns that taxonomy as a tree per asset type.

Every node carries a stable `id` (a UUID that survives renames and reorders — safe to use as a Blender catalog id), its canonical `path`, a URL-safe `slugPath`, a human `description`, and its `children`.

Categories describe **what an asset is**. Qualities like weather, condition or material are separate *attributes* (`asset.attributes`), whose schema is returned alongside the tree.

## Response `200`

OK

- object
  - `types` object — Category tree, keyed by asset type.
  - `attributes` object — Attribute schema, keyed by asset type.

---

[API](https://skmtc.net/poly-haven/apis/poly-haven-api.md) · [All operations](https://skmtc.net/poly-haven/apis/poly-haven-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly-haven/poly-haven-api/versions/0084c193ae7e/schema)