> ## Documentation Index > Fetch the complete documentation index at: https://docs.snagsolutions.io/llms.txt > Use this file to discover all available pages before exploring further. # Get auction bids > Returns a list of auction bids with optional filtering and pagination. ## OpenAPI ````yaml /api-reference/openapi.documented.json get /api/auction_bids openapi: 3.0.2 info: title: Snag Solutions - API Docs description: >- Documentation for Loyalty & Socials APIs. Some endpoints require an API key to authenticate. To obtain a key, reach out to the Snag Solutions team at support@snagsolutions.io. version: '0.1' servers: - url: https://admin.snagsolutions.io/ description: Production security: [] paths: /api/auction_bids: get: tags: - Auction summary: Get auction bids description: Returns a list of auction bids with optional filtering and pagination. parameters: - name: id in: query description: The bid ID(s) - accepts a single ID or an array of IDs schema: oneOf: - type: string format: uuid - type: array items: type: string format: uuid - {} title: ID example: 123e4567-e89b-12d3-a456-426614174010 - name: userId in: query description: ID of the user who made the bid schema: type: string format: uuid title: User ID example: 123e4567-e89b-12d3-a456-426614174001 - name: walletAddress in: query description: Wallet address of the bidder schema: type: string title: Wallet Address example: '0x1234567890abcdef1234567890abcdef12345678' - name: startingAfter in: query description: Pagination cursor to start after a specific bid ID schema: type: string format: uuid title: Starting After example: 123e4567-e89b-12d3-a456-426614174020 - name: limit in: query description: Maximum number of bids to return schema: type: integer minimum: 1 maximum: 1000 title: Limit example: 50 - name: organizationId in: query description: ID of the organization schema: type: string format: uuid title: Organization ID example: 123e4567-e89b-12d3-a456-426614174002 - name: websiteId in: query description: ID of the website schema: type: string format: uuid title: Website ID example: 123e4567-e89b-12d3-a456-426614174003 - name: auctionId in: query description: ID of the auction schema: type: string format: uuid title: Auction ID example: 123e4567-e89b-12d3-a456-426614174004 - name: status in: query description: Status of the bid schema: type: string enum: - submitted - accepted - rejected - fulfilled title: Bid Status example: PENDING - name: orderBy in: query description: Order bids by amount (ascending or descending). Defaults to desc. schema: type: string enum: - asc - desc title: Order By example: desc - name: skip in: query description: Number of bids to skip (for offset-based pagination) schema: type: integer minimum: 0 nullable: true title: Skip example: 1999 - name: includeCount in: query description: Include total count of matching bids in response schema: type: boolean nullable: true title: Include Count example: true - name: statuses in: query description: Filter by multiple bid statuses (OR condition) schema: type: array items: type: string enum: - submitted - accepted - rejected - fulfilled title: Statuses example: - accepted - fulfilled responses: '200': description: '200' content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string format: uuid amount: nullable: true status: type: string enum: - submitted - accepted - rejected - fulfilled auctionId: type: string format: uuid auctionItemId: type: string format: uuid nullable: true currencyAddress: type: string nullable: true currencyDecimals: type: number updatedAt: type: string format: date-time auctionItem: type: object properties: id: type: string format: uuid quantity: type: number mintingContractAsset: type: object properties: id: type: string format: uuid isPhygitalItem: type: boolean shippingPrice: nullable: true tokenId: type: number nullable: true revealedAt: type: string format: date-time nullable: true required: - id - isPhygitalItem - tokenId - revealedAt nullable: true required: - id - quantity - mintingContractAsset nullable: true user: type: object properties: id: type: string format: uuid walletAddress: type: string required: - id - walletAddress loyaltyCurrency: type: object properties: id: type: string format: uuid name: type: string symbol: type: string decimals: type: number imageUrl: type: string nullable: true apiGetUrl: type: string nullable: true apiGetTransactionEntryUrl: type: string nullable: true apiPostUrl: type: string nullable: true apiAuthType: type: string enum: - none - basic - bearer - apiKey nullable: true apiAuthKey: type: string nullable: true apiAuthValue: type: string nullable: true required: - id - name - symbol - decimals - imageUrl - apiGetUrl - apiGetTransactionEntryUrl - apiPostUrl - apiAuthType - apiAuthKey - apiAuthValue nullable: true auction: type: object properties: id: type: string format: uuid name: type: string required: - id - name nullable: true required: - id - status - auctionId - auctionItemId - currencyAddress - currencyDecimals - updatedAt - auctionItem - user - loyaltyCurrency - auction title: Get Auction Bids Response Schema description: Schema for a get auction bids response hasNextPage: type: boolean title: Has Next Page description: Indicates if there is a next page of results count: type: number title: Count description: >- Total count of matching bids (only present when includeCount=true) required: - data - hasNextPage '403': description: '403' content: application/json: schema: type: object properties: message: type: string title: Message description: Error message example: Forbidden, Could not validate api key required: - message title: Forbidden Response description: Schema for forbidden response example: Forbidden, Could not validate api key '500': description: '500' content: application/json: schema: type: object properties: success: type: boolean title: Success description: Indicates operation success example: false message: type: string title: Message description: Error message example: Internal server error debugInfo: type: string title: Debug Info description: Optional debug information example: Stack trace or additional error details required: - success - message title: Internal Server Error Response description: Schema for internal server error response security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-KEY ````