---
title: "Get attachments list with pagination and filters"
method: GET
path: "/admin/attachments"
tags: ["Admin Attachments"]
---

# Get attachments list with pagination and filters

`GET /admin/attachments`

Retrieve a paginated list of attachments with optional filtering by search terms, type, status, explicit content flag, and user ID

## Query parameters

- `page` number
- `limit` number
- `search` string
- `type` 'image' | 'video' | 'audio' | 'gift' | 'all'
- `status` 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TIMED_OUT'
- `explicit` boolean
- `userId` string
- `from` string
- `to` string
- `isFromUser` boolean

## Response `200`

Attachments list retrieved successfully

- AttachmentsListResponseDto
  - `attachments` AttachmentListItemDto[], required — List of attachments
    - `id` string, required — Attachment ID
    - `messageId` string, required — Message ID
    - `chatId` string, required — Chat ID
    - `userId` string, required — User ID
    - `prompt` string, nullable, required — Prompt used for generation
    - `type` 'image' | 'video' | 'audio' | 'gift' | 'all', required — Attachment type
    - `explicit` boolean, required — Explicit content flag
    - `s3Key` string, required — S3 key
    - `mimeType` string, nullable, required — MIME type
    - `status` 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TIMED_OUT', required — Status
    - `url` string, required — CDN URL
    - `videoUrl` string, nullable, required — Video CDN URL
    - `createdAt` string, date-time, required — Created At
    - `updatedAt` string, date-time, required — Updated At
    - `isFromUser` boolean, required — Whether the attachment was sent by the user
  - `total` number, required — Total number of attachments
  - `page` number, required — Current page number
  - `limit` number, required — Number of items per page
  - `totalPages` number, required — Total number of pages

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)
