> ## 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.

# List Assets

> Get a list of assets from your library

Returns an array of assets from your library. Supports filtering by type and status, with pagination via query parameters.

Pagination metadata is returned in response headers:

| Header          | Description                                 |
| --------------- | ------------------------------------------- |
| `X-Total-Count` | Total number of assets matching the filters |
| `X-Page`        | Current page number                         |
| `X-Page-Size`   | Number of items per page                    |
| `X-Total-Pages` | Total number of pages                       |

## Asset Types

| Type    | Description                                       |
| ------- | ------------------------------------------------- |
| `AUDIO` | Audio files for background music (system library) |
| `IMAGE` | Uploaded images for use as B-roll                 |
| `VIDEO` | Uploaded videos for use as B-roll                 |

## Examples

```bash theme={null}
# All assets (default: READY status)
GET /assets

# Only video assets
GET /assets?type=VIDEO

# Images and videos, page 2
GET /assets?type=IMAGE&type=VIDEO&page=2&pageSize=10
```

***


## OpenAPI

````yaml get /assets
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:
    get:
      summary: List assets
      description: >-
        Returns a paginated list of assets from your library. Includes
        user-uploaded assets and system assets (e.g. music library).
      parameters:
        - name: type
          in: query
          description: >-
            Filter by asset type. Can be specified multiple times (e.g.
            `?type=VIDEO&type=IMAGE`). Omit to return all types.
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - AUDIO
                - IMAGE
                - VIDEO
        - name: status
          in: query
          description: 'Filter by processing status. Default: READY.'
          required: false
          schema:
            type: string
            enum:
              - PROCESSING
              - READY
              - FAILED
            default: READY
        - name: page
          in: query
          description: Page number
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: pageSize
          in: query
          description: Number of items per page
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
      responses:
        '200':
          description: An array of assets. Pagination metadata is in response headers.
          headers:
            X-Total-Count:
              schema:
                type: integer
              description: Total number of assets matching the filters
            X-Page:
              schema:
                type: integer
              description: Current page number
            X-Page-Size:
              schema:
                type: integer
              description: Number of items per page
            X-Total-Pages:
              schema:
                type: integer
              description: Total number of pages
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Asset'
        '400':
          description: Unexpected error
          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

````