---
title: 'Get auction items'
description: 'Returns a paginated list of auction items for the given auction ID(s).'
openapi: GET /api/auctions/items
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.snagsolutions.io/llms.txt). Append `.md` to any page URL for its markdown version.

`GET /api/auctions/items` — query parameters: `auctionId`, `organizationId`, `websiteId`, `limit`

`GET https://admin.snagsolutions.io/api/auctions/items`

Returns a paginated list of auction items for the given auction ID(s).

## Authentication

- `apiKeyAuth` — apiKey in header: `X-API-KEY`

## Query parameters

- `auctionId` (string, required) — Comma-separated list of auction UUIDs to fetch items for (at least one required)
- `organizationId` (string) — Optional organization ID for scoping
- `websiteId` (string) — Optional website ID for scoping
- `limit` (integer) — Number of items to return (1-100, default 10)

## Response 200

200
  - response (object) — Schema for the response when fetching auction items
    - `data` (array, required)
      - `items` (object) — Schema representing an auction item
        - `id` (string, uuid, required)
        - `sortId` (number, required)
        - `quantity` (number, required)
        - `mintingContractAsset` (object, required) — Schema representing a minting contract asset
          - `id` (string, uuid, required)
    - `hasNextPage` (boolean, required)

## Response 403

403
  - response (object) — Schema for forbidden response
    - `message` (string, required) — Error message

## Response 500

500
  - response (object) — Schema for internal server error response
    - `success` (boolean, required) — Indicates operation success
    - `message` (string, required) — Error message
    - `debugInfo` (string) — Optional debug information


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.snagsolutions.io/api-specs.zip