---
title: "Get auctions with filtering and pagination"
method: GET
path: "/api/v1/auctions"
tags: ["auctions"]
---

# Get auctions with filtering and pagination

`GET /api/v1/auctions`

Retrieve auctions with optional filtering by state, slot range, and other criteria.
      Results are paginated and include metadata for navigation.

## Query parameters

- `state` 'pending' | 'bidding' | 'closing' | 'settling' | 'settled' | 'finalizing' | 'finalized' | 'disputed' | 'cancelled'
- `fromSlot` number
- `toSlot` number
- `limit` number
- `offset` number

## Response `200`

Paginated list of auctions with metadata

- PaginatedAuctionsResponseDto
  - `data` AuctionResponseDto[], required — Array of auction data
    - `id` string, required — Unique auction identifier
    - `slot` number, required — Slot number
    - `state` 'pending' | 'bidding' | 'closing' | 'settling' | 'settled' | 'finalizing' | 'finalized' | 'disputed' | 'cancelled', required — Current auction state
    - `createdAt` string, date-time, required — Auction creation timestamp
    - `biddingDeadline` string, date-time, required — Bidding deadline timestamp
    - `settlementDeadline` string, date-time, required — Settlement deadline timestamp
    - `finalizedAt` string, date-time — Finalization timestamp
    - `metadata` object — Auction metadata
    - `totalBids` number, required — Total number of bids
    - `clearingPrice` string — Clearing price in wei
    - `totalAllocated` number — Total allocated quantity
  - `meta` PaginationMetaDto, required
    - `page` number, required — Current page number (0-based)
    - `limit` number, required — Number of items per page
    - `total` number, required — Total number of items
    - `totalPages` number, required — Total number of pages
    - `hasNext` boolean, required — Whether there is a next page
    - `hasPrevious` boolean, required — Whether there is a previous page
    - `currentPageItems` number, required — Number of items on current page
  - `links` PaginationLinksDto, required
    - `first` string, required — URL for the first page
    - `previous` string, nullable, required — URL for the previous page
    - `self` string, required — URL for the current page
    - `next` string, nullable, required — URL for the next page
    - `last` string, required — URL for the last page

## Other responses

- `400` — Invalid query parameters

---

[API](https://skmtc.dev/manifoldfinance/apis/eigenlayer-public-api-specification.md) · [All operations](https://skmtc.dev/manifoldfinance/apis/eigenlayer-public-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/manifoldfinance/eigenlayer-public-api-specification/revisions/068b24703dfe/schema)