Search auction items

Returns a paginated list of auction items that match the search query.

get

Authorizations

AuthorizationstringRequired

Your storefront (public) token, sent as Authorization: Bearer STOREFRONT_TOKEN. Generate one in Auction Plus under Settings > API, in the Storefront API section, by clicking Generate Public Token. Required on every request.

Query parameters

filter[status]string · enumOptionalPossible values:

filter[viewerHasBid]string · enumOptional

Limit results to auction items the authenticated customer has bid on.

Possible values:

filter[eventId]stringOptional

viewerFieldsstring · nullableOptional

Comma-separated per-viewer fields to return under meta.viewer on the resource and any included resources. Available values: hasBid, isWatching, isHighBidder, isOwner. Requires an authenticated customer.

perPageinteger · min: 1 · max: 100Optional

Results per page (1–100).

querystring · min: 1 · max: 100Required

The text to match against auction item titles.

fields[auction-items]stringOptional

Available values are startPrice, bidIncrementStrategy, automaticBidding, softClose, totalBids, highBidAmount, minimumBid, currentIncrement, startsAt, endsAt, position, status, enableReserve, reserveMet, processed, createdAt, updatedAt, canceledAt. You can include multiple values by separating them with a comma.

fields[variants]stringOptional

Available values are externalId, displayName, title, price, photoUrl. You can include multiple values by separating them with a comma.

fields[products]stringOptional

Available values are externalId, title, vendor, type, photoUrl, handle. You can include multiple values by separating them with a comma.

fields[bids]stringOptional

Available values are amount, placedAt. You can include multiple values by separating them with a comma.

fields[max-bids]stringOptional

Available values are amount, createdAt. You can include multiple values by separating them with a comma.

fields[auction-winners]stringOptional

Available values are amount, notifiedAt, paymentDueAt. You can include multiple values by separating them with a comma.

includestringOptional

Comma-separated list of related resources to include in the response. Available values: variant, product, highBid, highBid.customer, viewerMaxBid, viewerWin.

sortstringOptional

Sort by field. Prefix with - for descending order. Available values: startsAt, -startsAt, endsAt, -endsAt, totalBids, -totalBids.

Responses

200

Paginated set of AuctionItemResource

application/vnd.api+json

401

Unauthenticated

application/vnd.api+json

422

Validation error

application/vnd.api+json

get/auction-items/search

GET /storefront/v1/auction-items/search?query=text HTTP/1.1
Host: api.auctionplusapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "pvrxnwvdgn2g14k4py4yqg36j4",
      "type": "auction-items",
      "attributes": {
        "startPrice": {
          "value": 100,
          "major": "1.00",
          "display": "$1.00",
          "currency": "USD"
        },
        "bidIncrementStrategy": {
          "strategy": "fixed_amount",
          "value": {
            "amount": {
              "value": 500,
              "major": "5.00",
              "display": "$5.00",
              "currency": "USD"
            }
          }
        },
        "automaticBidding": {
          "enabled": true
        },
        "softClose": {
          "enabled": false
        },
        "totalBids": 1,
        "highBidAmount": {
          "value": 5000,
          "major": "50.00",
          "display": "$50.00",
          "currency": "USD"
        },
        "minimumBid": {
          "value": 5500,
          "major": "55.00",
          "display": "$55.00",
          "currency": "USD"
        },
        "currentIncrement": {
          "value": 500,
          "major": "5.00",
          "display": "$5.00",
          "currency": "USD"
        },
        "startsAt": "2026-08-28T13:52:12.000000Z",
        "endsAt": "2026-08-28T14:52:12.000000Z",
        "position": null,
        "status": "active",
        "enableReserve": true,
        "reserveMet": true,
        "processed": false,
        "createdAt": "2026-08-28T13:52:12.000000Z",
        "updatedAt": "2026-08-28T13:52:12.000000Z",
        "canceledAt": null
      },
      "relationships": {
        "variant": {
          "data": {
            "type": "variants",
            "id": "text"
          }
        },
        "product": {
          "data": {
            "type": "products",
            "id": "text"
          }
        },
        "highBid": {
          "data": {
            "type": "bids",
            "id": "text"
          }
        },
        "viewerMaxBid": {
          "data": {
            "type": "max-bids",
            "id": "text"
          }
        },
        "viewerWin": {
          "data": {
            "type": "auction-winners",
            "id": "text"
          }
        }
      }
    }
  ],
  "meta": {
    "currentPage": 1,
    "from": null,
    "lastPage": 1,
    "perPage": 1,
    "to": null,
    "total": 1
  }
}