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

# Get Asset

> Get an asset by ID with its current processing status

Returns an asset with its current processing status and metadata. Use this endpoint to poll for processing completion after uploading an asset.

## Status Lifecycle

```
POST /assets → PROCESSING → READY (or FAILED)
```

| Status       | Description                             |
| ------------ | --------------------------------------- |
| `PROCESSING` | Asset is being downloaded and processed |
| `READY`      | Asset is ready to use as B-roll         |
| `FAILED`     | Processing failed — upload a new asset  |

***


## OpenAPI

````yaml get /assets/{id}
openapi: 3.0.1
info:
  title: Argil API
  description: API for AI clone video generation
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: https://api.argil.ai/v1
security:
  - ApiKeyAuth: []
paths:
  /assets/{id}:
    get:
      summary: Get an asset by ID
      description: Returns a single asset with its current processing status and metadata.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: The ID of the asset to retrieve
      responses:
        '200':
          description: Asset details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Asset'
        '404':
          description: Asset not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Asset:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          nullable: true
        type:
          type: string
          enum:
            - AUDIO
            - IMAGE
            - VIDEO
        status:
          type: string
          enum:
            - PROCESSING
            - READY
            - FAILED
          description: Processing status. Poll until READY before using as B-roll.
        fileUrl:
          type: string
          nullable: true
          description: URL to access the asset. Null while processing.
        thumbnailUrl:
          type: string
          nullable: true
          description: URL to a thumbnail image. Null while processing.
        createdAt:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key to be included in the x-api-key header

````