---
title: "Get Assets"
method: GET
path: "/v1/assets"
tags: ["assets", "public"]
---

# Get Assets

`GET /v1/assets`

Retrieve asset IDs from a project.

Parameters:
- asset_ids (List[str], optional): The list of asset IDs to retrieve. This is optional, but will override the proj_id if provided.
- proj_id (str, optional): The id of the project. This is optional, but will be used if asset_ids is not provided.
- status (AssetStatus, optional): Filters the results based on the status of the assets.
- limit (int, optional): The number of transformations to retrieve.
- offset (int, optional): The offset to start retrieving transformations from.
- order_by (str, optional): The column to order the transformations by.
- order (str, optional): The order to sort the transformations by.

If neither asset_ids or proj_id is provided, all assets will be retrieved.

Returns:
- dict: A dict containing the all the asset data.

## Query parameters

- `asset_ids` string[] — List of asset IDs to retrieve.
- `proj_id` string — The id of the project.
- `transform_id` string — The id of the transformation.
- `row_id` string — Row ID where the asset belongs
- `operation_id` string — Operation ID where the asset belongs
- `entity_id` string — Entity ID where the asset belongs
- `entity_field_id` string — Entity field ID where the asset belongs
- `status` 'uploading' | 'uploaded' | 'failed_upload' | 'processing' | 'not_processed' | 'processed' — An enumeration.
- `limit` integer
- `offset` integer
- `order_by` 'updated_at' | 'created_at' | 'id' — An enumeration.
- `order` 'asc' | 'desc' — An enumeration.

## Headers

- `API-Version` string — Pass in an API version to guarantee a consistent response format. The latest version should be used for all new API calls. Existing API calls should be updated to the latest version when possible. **Valid versions:** - Latest API version (recommended): `2025-03` - Previous API version (maintenance mode): `2025-02` If no API version header is included, the response format is considered unstable and could change without notice (not recommended).

## Response `200`

Successful Response

- AssetsResponse
  - `message` string, required
  - `metadata` AssetsResponseMetadata
    - `total_results_count` integer, required
    - `total_filtered_results_count` integer, required
  - `data` AssetsBaseResponse[], required
    - `asset_id` string, required
    - `ext_file_name` string
    - `ext_file_id` string
    - `file_type` string
    - `url` string
    - `status` 'uploading' | 'uploaded' | 'failed_upload' | 'processing' | 'not_processed' | 'processed', required — An enumeration.
    - `proj_id` string
    - `transform_id` string
    - `entity_id` string
    - `created_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `408` — Request Timeout
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/runtrellis/apis/trellis.md) · [All operations](https://skmtc.dev/runtrellis/apis/trellis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runtrellis/trellis/revisions/b7d8570ff3cc/schema)