---
title: "API · Assets · List or search the workspace's assets"
method: GET
path: "/api/v1/assets"
tags: ["assets"]
---

# API · Assets · List or search the workspace's assets

`GET /api/v1/assets`

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v1/assets`
- Auth: API key in header `Authorization`

The assets in the authenticated workspace/teamspace. Omit `search` to
list them, newest first; pass it to narrow by asset name or tag.

`search` is text matching, not visual or semantic. A search term
includes matching assets stored inside folders; it does not search
folder names or return every asset in a named folder. `asset_type`
narrows either form, so listing only videos needs no search term.

Results contain asset UUIDs (`id`), `asset_name`, `asset_type`, `status`,
and thumbnail metadata. Use the UUIDs directly as social post media.
Call `getAsset` for full asset details and fresh stored URLs.
Follow pagination by incrementing `page` with the same search and filters
when the response indicates another page. Do not stop after the first
page when the user asks for all matching assets.

## Query parameters

- `search` string
- `asset_type` integer
- `page` integer
- `page_size` integer

## Response `200`

Paginated matching asset records with their UUIDs and metadata.

- unknown

## Other responses

- `401`: Unauthorized
- `404`: Invalid page or inaccessible workspace/teamspace

---

[API](https://skmtc.dev/simplified/apis/platform.md) - [All operations](https://skmtc.dev/simplified/apis/platform/llms.txt) - [OpenAPI document](https://skmtc.dev/simplified/apis/platform/revisions/0815a1ba1e4e?raw)