---
title: "Get asset metadata and a signed download URL"
method: GET
path: "/v1/assets/{id}"
tags: ["Models"]
---

# Get asset metadata and a signed download URL

`GET /v1/assets/{id}`

## Request

- Base URL: `https://api.sandbase.ai`
- URL: `https://api.sandbase.ai/v1/assets/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Asset metadata

- GetAssetResponse
  - `id` string, required
  - `external_id` string, required
  - `asset_url` string, required: Persistent asset:// reference used in generation requests.
  - `asset_type` 'Image' | 'Video' | 'Audio', required
  - `name` string
  - `status` string, required: Provider-reported asset status, returned without normalization.
  - `download_url` string, required: Provider-returned download URL. It can be empty until the provider makes a URL available.
  - `created_at` string, date-time, required

## Other responses

- `401`: Missing or invalid API key
- `402`: API key spending limit exceeded
- `403`: API key scope does not authorize this endpoint
- `404`: Asset not found
- `500`: Internal asset lookup error or provider credentials are unavailable
- `502`: Upstream asset query failed

---

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