---
title: 'Get auction bids'
description: 'Returns a list of auction bids with optional filtering and pagination.'
openapi: GET /api/auction_bids
---

> **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/auction_bids` — query parameters: `id`, `userId`, `walletAddress`, `startingAfter`, `limit`, `organizationId`, `websiteId`, `auctionId`, `status`, `orderBy`, `skip`, `includeCount`, `statuses`

`GET https://admin.snagsolutions.io/api/auction_bids`

Returns a list of auction bids with optional filtering and pagination.

## Authentication

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

## Query parameters

- `id` (string) — The bid ID(s) - accepts a single ID or an array of IDs
- `userId` (string) — ID of the user who made the bid
- `walletAddress` (string) — Wallet address of the bidder
- `startingAfter` (string) — Pagination cursor to start after a specific bid ID
- `limit` (integer) — Maximum number of bids to return
- `organizationId` (string) — ID of the organization
- `websiteId` (string) — ID of the website
- `auctionId` (string) — ID of the auction
- `status` (string) — Status of the bid
- `orderBy` (string) — Order bids by amount (ascending or descending). Defaults to desc.
- `skip` (integer) — Number of bids to skip (for offset-based pagination)
- `includeCount` (boolean) — Include total count of matching bids in response
- `statuses` (array) — Filter by multiple bid statuses (OR condition)

## Response 200

200
  - response (object)
    - `data` (array, required)
      - `items` (object) — Schema for a get auction bids response
        - `id` (string, uuid, required)
        - `status` (string, required, one of: submitted, accepted, rejected, fulfilled)
        - `auctionId` (string, uuid, required)
        - `auctionItemId` (string, uuid, required)
        - `currencyAddress` (string, required)
        - `currencyDecimals` (number, required)
        - `updatedAt` (string, date-time, required)
        - `auctionItem` (object, required)
          - `id` (string, uuid, required)
          - `quantity` (number, required)
          - `mintingContractAsset` (object, required)
            - id: … (nested further)
            - isPhygitalItem: … (nested further)
            - shippingPrice: … (nested further)
            - tokenId: … (nested further)
            - revealedAt: … (nested further)
        - `user` (object, required)
          - `id` (string, uuid, required)
          - `walletAddress` (string, required)
        - `loyaltyCurrency` (object, required)
          - `id` (string, uuid, required)
          - `name` (string, required)
          - `symbol` (string, required)
          - `decimals` (number, required)
          - `imageUrl` (string, required)
          - `apiGetUrl` (string)
          - `apiGetTransactionEntryUrl` (string)
          - `apiPostUrl` (string)
          - `apiAuthType` (string, one of: none, basic, bearer, apiKey)
          - `apiAuthKey` (string)
          - `apiAuthValue` (string)
        - `auction` (object, required)
          - `id` (string, uuid, required)
          - `name` (string, required)
    - `hasNextPage` (boolean, required) — Indicates if there is a next page of results
    - `count` (number) — Total count of matching bids (only present when includeCount=true)

## 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