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

# List Assets

`GET /v1/assets`

## Request

- Base URL: `https://api.pinbridge.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pinbridge.io/v1/assets`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

List all assets for the organization, with optional filters.

`total` in the body (and the `X-Total-Count` header) counts the assets
matching the filters and search, ignoring `limit` and `offset`.

## Query parameters

- `workspace_id` string, uuid, nullable
- `sort` 'created_at_desc' | 'created_at_asc' | 'name_asc' | 'name_desc' | 'size_desc' | 'size_asc': Sort order
- `limit` integer
- `offset` integer
- `q` string, nullable: Case-insensitive search on the original file name
- `asset_type` 'image' | 'video': Supported uploaded asset types.
- `in_use` boolean, nullable: true: only assets used by a pin or a pending scheduled pin; false: only unused assets
- `since` string, date-time, nullable: Only assets uploaded at or after this ISO 8601 timestamp
- `until` string, date-time, nullable: Only assets uploaded before this ISO 8601 timestamp

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- AssetListResponse: Paginated asset list with storage summary.
  - `assets` AssetResponse[], required
    - `id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `workspace_environment` 'production' | 'sandbox': Environment mode for an isolated project/workspace.
    - `asset_type` 'image' | 'video', required: Supported uploaded asset types.
    - `original_filename` string, required
    - `stored_filename` string, required
    - `content_type` string, required
    - `file_size_bytes` integer, required
    - `file_size_display` string, required
    - `referenced_by_pin_count` integer: Pins plus scheduled pins that have not run yet using this asset.
    - `public_url` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required
  - `storage_used_bytes` integer, required
  - `storage_quota_bytes` integer, required
  - `storage_used_percent` integer, required

## Other responses

- `422`: Validation Error

---

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