---
title: "A list of assets, including their individual metadata."
method: GET
path: "/assets"
tags: ["assets"]
---

# A list of assets, including their individual metadata.

`GET /assets`

To filter the returned data, some **optional arguments** can by provided in the request URL (e.g. `/assets?t=hdris&c=outdoor`)

## Query parameters

- `type` string
- `categories` string
- `category` string
- `collection` string
- `vault` string
- `attributes` string

## Response `200`

OK

- Assets
  - `assetID` object — Asset data, see schema for `asset`.

## Other responses

- `400` — Bad request, e.g. unsupported asset type or unknown category

## Changes

> 15 revisions in range; 1 could not be searched.

- **2026-07-28** `119908544f81` — 4 info
  - added the new optional `query` request parameter `attributes`
  - added the new optional `query` request parameter `category`
  - added the new optional `query` request parameter `collection`
  - added the new optional `query` request parameter `vault`
- **2023-06-21** `a505e6285475` — 1 warning
  - deleted the `query` request parameter `author`
- **2022-02-09** `a3eb4c7a1e91` — 1 info
  - added the new optional `query` request parameter `author`

[Change history](https://skmtc.dev/poly-haven/apis/poly-haven-api/changes/assets/get.md)

---

[API](https://skmtc.dev/poly-haven/apis/poly-haven-api.md) · [All operations](https://skmtc.dev/poly-haven/apis/poly-haven-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/poly-haven/poly-haven-api/revisions/cf483872e25a/schema)