# List assets

Retrieves a paginated list of assets with optional filtering using bracket notation.

Endpoint: GET /v1/assets
Version: 1.0.0
Security: Bearer

## Query parameters:

  - `status[eq]` (string)
    Filter by exact status match.
    Enum: "draft", "published", "unpublished", "archived", "removed"

  - `status[order]` (string)
    Sort order for status field. Values: asc, desc.

  - `category[eq]` (string)
    Filter by exact category match.
    Enum: "image", "video", "audio", "document", "design", "archive", "data"

  - `category[order]` (string)
    Sort order for category field. Values: asc, desc.

  - `storageLocation[eq]` (string)
    Filter by exact storage location match.
    Enum: "s3"

  - `name[eq]` (string)
    Filter by exact name match.

  - `name[contains]` (string)
    Filter by partial name match.

  - `name[starts]` (string)
    Filter by name prefix.

  - `name[ends]` (string)
    Filter by name suffix.

  - `name[order]` (string)
    Sort order for name field. Values: asc, desc.

  - `createdAt[eq]` (string)
    Filter by exact creation timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `createdAt[min]` (string)
    Filter by minimum creation timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `createdAt[max]` (string)
    Filter by maximum creation timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `createdAt[order]` (string)
    Sort order for creation timestamp. Values: asc, desc.

  - `updatedAt[eq]` (string)
    Filter by exact update timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `updatedAt[min]` (string)
    Filter by minimum update timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `updatedAt[max]` (string)
    Filter by maximum update timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `updatedAt[order]` (string)
    Sort order for update timestamp. Values: asc, desc.

  - `isArchived[eq]` (boolean)
    Filter by archived status. Values: true, false.

  - `isRemoved[eq]` (boolean)
    Filter by removed status. Values: true, false.

  - `page` (integer)
    Page number for pagination. Default is 1.

  - `size` (integer)
    Page size for pagination. Default is 20.

  - `include[metadata]` (boolean)
    Include metadata. Values: true, false.

  - `include[files]` (boolean)
    Include files. Values: true, false.

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.uuid` (string, required)
    Unique identifier for this asset.

  - `items.createdAt` (string, required)
    Timestamp when this asset was created.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.updatedAt` (string, required)
    Timestamp when this asset was last modified.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.removedAt` (string,null)
    Timestamp when this asset was removed. Null if not removed.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.archivedAt` (string,null)
    Timestamp when this asset was archived. Null if not archived.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.status` (string, required)
    Current lifecycle status of this asset.
    Enum: "draft", "published", "unpublished", "archived", "removed"

  - `items.category` (string, required)
    Category classification for this asset.
    Enum: "image", "video", "audio", "document", "design", "archive", "data"

  - `items.storageLocation` (string, required)
    Storage backend where associated files reside.
    Enum: "s3"

  - `items.name` (string,null)
    Display name for this asset.

  - `items.description` (string,null)
    Optional detailed description for this asset.

  - `items.altText` (string,null)
    Alternative text for accessibility and SEO purposes.

  - `items.metadata` (array,null)
    Collection of custom metadata key-value pairs associated with this asset.

  - `items.metadata.uuid` (string, required)
    Unique identifier for this metadata entry.

  - `items.metadata.createdAt` (string, required)
    Timestamp when this metadata entry was created.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.metadata.updatedAt` (string, required)
    Timestamp when this metadata entry was last modified.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.metadata.key` (string, required)
    Metadata key name.

  - `items.metadata.value` (string, required)
    Metadata value content.

  - `items.files` (array,null)
    Collection of files associated with this asset.

  - `items.files.uuid` (string, required)
    Unique identifier for this file.

  - `items.files.createdAt` (string, required)
    Timestamp when this file was created.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.files.status` (string, required)
    Current lifecycle status of this file.
    Enum: "awaitingUpload", "uploaded"

  - `items.files.variationType` (string, required)
    Type of file variation.
    Enum: "original", "thumbnail", "webOptimized", "mobileOptimized", "productDetail", "printReady", "socialMedia", "videoPoster", "videoPreview", "videoStreamLow", "videoStreamMedium", "videoStreamHigh"

  - `items.files.storageLocation` (string, required)
    Storage backend where this file is stored.
    Enum: "s3"

  - `items.files.mimeType` (string, required)
    MIME type of this file.

  - `items.files.extension` (string, required)
    File extension of this file.

  - `items.files.storageKey` (string, required)
    Storage backend key path for this file.

  - `items.files.storageSize` (integer,null)
    File size in bytes. Null if not yet calculated.

  - `items.files.checksum` (string, required)
    SHA-256 checksum for file integrity verification.

  - `items.files.isAutogenerated` (boolean, required)
    Whether this file was automatically generated by the system.

  - `items.files.presignedUrl` (string, required)
    Temporary pre-signed URL for downloading this file.

  - `pagination` (object, required)

  - `pagination.page` (integer, required)

  - `pagination.size` (integer, required)

  - `pagination.totalItems` (integer, required)

  - `pagination.totalPages` (integer, required)

## Response 401 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

## Response 403 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)

## Response 500 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)