> For the complete documentation index, see [llms.txt](https://docs.auctionplusapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.auctionplusapp.com/admin-api/bids/list-auction-item-bids.md).

# List auction item bids

Returns a paginated list of bids placed on a single auction item, ordered by amount from highest to lowest.

```json
{"openapi":"3.1.0","info":{"title":"Auction Plus API Documentation","version":"1.0.0"},"tags":[{"name":"Bids","description":"A bid represents a single direct or max bid placed on an auction item. The list endpoint returns the public bid history for a listing.\n\nThe **amount** is returned as a price object containing **value** (minor units), **major**, **display**, and **currency** fields.\n\nThe **submittedAt** attribute represents when the bidder originally submitted the bid. For automatic bids, this is when the customer submitted the associated max bid. The **placedAt** attribute represents when the bid was placed into the system.\n\nThe **automatic** attribute is `true` when the bid was placed by the system on the customer's behalf using their max bid.\n\nInclude **customer** to return the bidder relationship for each bid."}],"servers":[{"url":"https://api.auctionplusapp.com/v1"}],"security":[{"http":[]}],"components":{"securitySchemes":{"http":{"type":"http","description":"You can retrieve your token by visiting Settings > API and clicking <b>Generate Public Token</b>.","scheme":"bearer"}},"schemas":{"BidResource":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"bids"},"attributes":{"type":"object","properties":{"amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"submittedAt":{"type":["string","null"],"format":"date-time"},"placedAt":{"type":["string","null"],"format":"date-time"},"automatic":{"type":["boolean","null"]}}}},"required":["id","type"],"title":"BidResource"},"Money":{"type":"object","properties":{"value":{"type":"integer"},"major":{"type":"string"},"display":{"type":"string"},"currency":{"type":"string"}},"required":["value","major","display","currency"],"title":"Money"}},"responses":{"AuthenticationException":{"description":"Unauthenticated","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","description":"The HTTP status code applicable to this problem, expressed as a string."},"code":{"type":"string","description":"An application-specific error code."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"id":{"type":"string","description":"A unique identifier for this particular occurrence of the problem."},"title":{"type":"string","description":"A short, human-readable summary of the problem."},"source":{"type":"object","description":"An object containing references to the source of the error.","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"},"header":{"type":"string"}}},"meta":{"type":"object","description":"A meta object containing additional information about the error."}},"required":["status","code","detail"]}}},"required":["errors"]}}}},"ValidationException":{"description":"Validation error","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","description":"The HTTP status code applicable to this problem, expressed as a string."},"code":{"type":"string","description":"An application-specific error code."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"id":{"type":"string","description":"A unique identifier for this particular occurrence of the problem."},"title":{"type":"string","description":"A short, human-readable summary of the problem."},"source":{"type":"object","description":"An object containing references to the source of the error.","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"},"header":{"type":"string"}}},"meta":{"type":"object","description":"A meta object containing additional information about the error."}},"required":["status","code","detail"]}}},"required":["errors"]}}}}}},"paths":{"/auction-items/{id}/bids":{"get":{"operationId":"listAuctionItemBids","description":"Returns a paginated list of bids placed on a single auction item, ordered by amount from highest to lowest.","summary":"List auction item bids","tags":["Bids"],"parameters":[{"name":"perPage","in":"query","description":"Results per page (1–100).","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"fields[bids]","in":"query","description":"Available values are `amount`, `submittedAt`, `placedAt`, `automatic`. You can include multiple values by separating them with a comma.","schema":{"type":"string"}},{"name":"fields[customers]","in":"query","description":"Available values are `name`, `firstName`, `lastName`, `externalId`, `email`, `registeredAt`, `approvedAt`, `bannedAt`, `createdAt`. You can include multiple values by separating them with a comma.","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"The auction item ID.","schema":{"type":"string"}},{"name":"include","in":"query","description":"Comma-separated list of related resources to include in the response. Available values: `customer`.","schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated set of `BidResource`","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/BidResource"},{"type":"object","properties":{"relationships":{"type":"object","properties":{"customer":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","enum":["customers"]},"id":{"type":"string"}},"required":["type","id"]}}}}}}}]}},"meta":{"type":"object","properties":{"currentPage":{"type":"integer","minimum":1},"from":{"type":["integer","null"],"minimum":1},"lastPage":{"type":"integer","minimum":1},"perPage":{"type":"integer","description":"Number of items shown per page.","minimum":0},"to":{"type":["integer","null"],"description":"Number of the last item in the slice.","minimum":1},"total":{"type":"integer","description":"Total number of items being paginated.","minimum":0}},"required":["currentPage","from","lastPage","perPage","to","total"]}},"required":["data","meta"]}}}},"401":{"$ref":"#/components/responses/AuthenticationException"},"422":{"$ref":"#/components/responses/ValidationException"}}}}}}
```