[DEPRECATED] GET /v3/bidder/my-items

GET

/v3/bidder/my-items

const url = 'https://api-ha-prod-p8.handbid.dev/v3/bidder/my-items?limit=20';
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-items?limit=20' \
  --header 'Authorization: Bearer <token>'

⚠️ DEPRECATED (HAN-1849, 2026-05-21). Replaced by GET /v3/bidder/my-cart (paid + unpaid purchases with totals block — the shopping-cart view) and GET /v3/bidder/my-activity (live event dashboard with derived statuses).

URL RESERVED: /v3/bidder/my-items will be reborn as the future dispatch / pickup / delivery endpoint when that system is built. Do not consume this endpoint going forward. Removed one release cycle after iOS confirms migration to my-cart + my-activity.

NEW (HAN-1585, 2026-05-19). Home-screen rail. Items the authenticated user has bid on OR purchased — broader than /v3/bidder/active-bids (the in-progress subset).

Item-status filter: all visible statuses (1,2,4,5,6,7,8,9,10,13) — this is a history rail, includes sold/closed items.

Response: { items: [ItemCard...], totalCount }. Each item is a standard ItemCardSerializer card + 4 extra fields:

purchaseAmount — SUM(grandTotal) decimal string, NULL for bid-only items.
purchaseStatus — paid | unpaid | null (null when no purchase row exists). Derived from receipts.paid.
purchasedAt — int epoch of latest purchase row’s dateInserted, NULL for bid-only.
receiptId — int id paired with purchasedAt from the SAME row (deterministic latest-row selection).

Sort: lastActivityAt DESC, i.id DESC — latest activity across bids + purchases.

Cache: 15s TTL, tag V3CacheTags::userMyItems — flushed on bid, purchase, or receipt paid toggle for this user.

Authorizations

bearer

Parameters

Query Parameters

limit

integer

Default 20, range 1-100

Example

Responses

200

Successful response

application/json