---
title: "List assets"
method: GET
path: "/api/v1/assets"
tags: ["Assets"]
---

# List assets

`GET /api/v1/assets`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/assets`
- Auth: none declared

## Query parameters

- `limit` integer: Page size, 1-200. Omit to return every asset (the historical behaviour).
- `cursor` string: Asset id of the last row of the previous page. Requires `limit`.

## Response `200`

Assets in the space, newest first, with file metadata and usage counts. Every asset when `limit` is omitted; otherwise one page, where `cursor` is the previous page's last asset id and a short page means the end.

- object[]
  - `id` string, required
  - `attachmentId` string, required
  - `name` string, required
  - `contentKind` 'text' | 'binary', required
  - `metadata` object
  - `fileName` string, required
  - `mimeType` string, required
  - `size` integer, required
  - `url` string, required
  - `contentHash` string, required
  - `usageCount` integer, required
  - `textStatus` 'missing' | 'present' | 'none' | 'stale', required
  - `createdAt` string, required

---

[API](https://skmtc.dev/busabase/apis/busabase-api.md) · [All operations](https://skmtc.dev/busabase/apis/busabase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/busabase/apis/busabase-api/revisions/bc6a7d5ff4c1?raw)