---
title: "Get an asset by ID"
method: GET
path: "/assets/{id}"
---

# Get an asset by ID

`GET /assets/{id}`

Returns a single asset with its current processing status and metadata.

## Path parameters

- `id` string, uuid, required — The ID of the asset to retrieve

## Response `200`

Asset details

- Asset
  - `id` string, uuid
  - `name` string, nullable
  - `type` 'AUDIO' | 'IMAGE' | 'VIDEO'
  - `status` 'PROCESSING' | 'READY' | 'FAILED' — Processing status. Poll until READY before using as B-roll.
  - `fileUrl` string, nullable — URL to access the asset. Null while processing.
  - `thumbnailUrl` string, nullable — URL to a thumbnail image. Null while processing.
  - `createdAt` string, date-time

## Other responses

- `404` — Asset not found

## Changes

- **2026-04-16** `3e376c91df56` — 3 breaking, 2 warning, 3 info
  - for the `path` request parameter `id`, the type/format was changed from `string`/`` to `string`/`uuid`
  - the response property `fileUrl` became nullable for the status `200`
  - the response property `name` became nullable for the status `200`
  - added the new `IMAGE` enum value to the `type` response property for the response status `200`
  - …4 more
- **2026-04-16** `ac2be3dc5af8` — 3 warning, 3 info
  - removed the optional property `createdAt` from the response with the `200` status
  - removed the optional property `status` from the response with the `200` status
  - removed the optional property `thumbnailUrl` from the response with the `200` status
  - for the `path` request parameter `id`, the type/format was generalized from `string`/`uuid` to `string`/``
  - …2 more
- **2026-04-16** `02d93799e8f1` — 3 breaking, 2 warning, 3 info
  - for the `path` request parameter `id`, the type/format was changed from `string`/`` to `string`/`uuid`
  - the response property `fileUrl` became nullable for the status `200`
  - the response property `name` became nullable for the status `200`
  - added the new `IMAGE` enum value to the `type` response property for the response status `200`
  - …4 more
- **2025-02-03** `5cc5ad59564f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/argildotai/apis/argil-api/changes/assets/:id/get.md)

---

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