> 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/storefront-api/auction-items.md).

# Auction Items

An auction item represents a single listing in an auction. Each item has a **status** of `scheduled`, `active`, or `completed`.

Price attributes such as **startPrice**, **minimumBid**, **currentIncrement**, and **highBidAmount** are returned as a price object containing **value** (minor units), **major**, **display**, and **currency** fields.

The **bidIncrementStrategy** describes the increment type — `fixed_amount`, `percentage`, or `tier` — along with a **value** object containing the increment details.

The **automaticBidding** and **softClose** objects expose a single `enabled` boolean indicating whether each feature is active for the item.

The **reserveMet** boolean indicates whether the current high bid meets the auction's reserve, without exposing the reserve price itself. The **processed** attribute indicates whether the listing has been finalized, including assigning a winner. Listings are typically processed within a minute after the end time.

Per-viewer fields (whether the authenticated customer has bid, is the high bidder, or is watching the item) are opt-in. Request fields by name with the `viewerFields` query parameter (e.g. `viewerFields=hasBid,isWatching`).