---
title: "List gifts (paginated)"
method: GET
path: "/v1/gifts"
tags: ["Gifts"]
---

# List gifts (paginated)

`GET /v1/gifts`

## Query parameters

- `page` number
- `limit` number

## Response `200`

List of gifts

- GetGiftsResponseDto
  - `items` GiftDto[], required
    - `id` string, required — Gift ID
    - `name` string, required — Gift name
    - `prompt` string — Optional prompt describing the gift
    - `imageS3key` string, required — S3 key under STATIC prefix
    - `isExplicit` boolean, required — Whether the gift is explicit/NSFW
    - `price` number, required — Gift price in coins
    - `createdAt` string, date-time, required — Creation timestamp
    - `updatedAt` string, date-time, required — Update timestamp
  - `total` number, required — Total number of gifts
  - `page` number, required — Current page
  - `limit` number, required — Items per page
  - `locale` string, required — Resolved locale used for localization

---

[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)