GET /v3/bidder/my-auctions

GET

/v3/bidder/my-auctions

const url = 'https://api-ha-prod-p8.handbid.dev/v3/bidder/my-auctions?whitelabelKey=handbid&limit=10';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api-ha-prod-p8.handbid.dev/v3/bidder/my-auctions?whitelabelKey=handbid&limit=10' \
  --header 'Authorization: Bearer <token>'

Authed personal list. Returns {auctions, totalCount} — no top-level featured key.

Phase 2 wire changes (HAN-1682, deployed 2026-05-06):

paddleNumber REMOVED.
Legacy backgroundColor REMOVED.
New backgroundGradient: {top, bottom} populated from the auction’s theme-editor gradient (auction_landing_page.mobileBGTopGradient / mobileBGBottomGradient). Field is OMITTED ENTIRELY when both gradient columns are null.
New featuredItems[] populated server-side, capped at 4 per auction. Each item: {id, name, imageUrl, currentPrice, bidCount, isFavorite}.
currency defaults to "USD" only when the auction has no configured currency (was previously always coalesced client-side; now coalesced in SQL).
New isFeatured boolean on every row (matches the new /v3/auctions row shape).
inferredRegion cut (was never shipped — region is resolved client-side via CoreLocation/iBeacon).

HAN-1847 home-screen rebuild (2026-05-21):

Accepts whitelabelKey (preferred, stable across environments) or whitelabelId (legacy). Defaults to whitelabelKey=handbid when neither is passed. Previously cross-whitelabel; now scopes to the configured WL — required for branded apps (Disney, Comcast, etc.) to see only their auctions.
Closed auctions (status=6) drop off after whitelabels.closedAuctionGraceDays (default 30) past their endTime. Tunable per WL.
Default limit reads from whitelabels.myAuctionsPageSize (default 3) — tunable per WL.
Populates auction-id cache v3:bidder:auction-ids:{userId}:{whitelabelKey} as a side-effect — consumed by /my-activity + /my-cart.
401 if token missing/invalid (normalized to V3 envelope).
429 on PIN/captcha rate-limit lock.

Authorizations

bearer

Parameters

Query Parameters

whitelabelKey

string

REQUIRED — defaults to ‘handbid’ when omitted. Scopes the response to a single whitelabel’s auctions. Legacy whitelabelId also accepted for backward compat.

Example

handbid

limit

integer

Default reads from whitelabels.myAuctionsPageSize (typically 3); range 1-100

Example

Responses

200

Successful response

application/json