> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iviker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query asset

Query a single asset's status and details.

```
GET /v1/assets/{id}
Authorization: Bearer <API_KEY>
```

`id` is the `asset_xxx` value returned by Create asset. Do not include the `asset://` prefix.

This endpoint is usually used to poll processing status until `status=active`, then the asset can be used in video generation.

## Example

```bash theme={null}
curl "https://{your-domain}/v1/assets/asset_6f9a4c2b8d1e3a90" \
  -H "Authorization: Bearer $API_KEY"
```

**Processing response:**

```json theme={null}
{
  "id": "asset_6f9a4c2b8d1e3a90",
  "uri": "asset://asset_6f9a4c2b8d1e3a90",
  "object": "asset",
  "asset_type": "image",
  "name": "avatar-reference",
  "status": "processing",
  "created_at": 1779782400,
  "updated_at": 1779782400
}
```

**Ready response:**

```json theme={null}
{
  "id": "asset_6f9a4c2b8d1e3a90",
  "uri": "asset://asset_6f9a4c2b8d1e3a90",
  "object": "asset",
  "asset_type": "image",
  "name": "avatar-reference",
  "status": "active",
  "created_at": 1779782400,
  "updated_at": 1779782460
}
```

## Asset statuses

| Status       | Description                                                                  | Usable in video generation |
| ------------ | ---------------------------------------------------------------------------- | -------------------------- |
| `processing` | The platform has accepted the asset and is storing or waiting to process it. | No                         |
| `active`     | The asset is ready.                                                          | Yes                        |
| `failed`     | Asset processing failed.                                                     | No                         |
| `disabled`   | Asset was disabled by the platform.                                          | No                         |

## Error codes

| HTTP status | `error.type`      | Scenario                                                                                          |
| ----------- | ----------------- | ------------------------------------------------------------------------------------------------- |
| 404         | `asset_not_found` | The asset does not exist, does not belong to the current user/domain, or the asset ID is invalid. |