GET /v3/bidder/invited-auctions

GET

/v3/bidder/invited-auctions

const url = 'https://api-ha-prod-p8.handbid.dev/v3/bidder/invited-auctions?limit=10&whitelabelId=%7B%7BwhitelabelId%7D%7D';
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/invited-auctions?limit=10&whitelabelId=%7B%7BwhitelabelId%7D%7D' \
  --header 'Authorization: Bearer <token>'

NEW (HAN-1684, 2026-05-06). Auctions the authenticated user was added to via email invitation but hasn’t registered for. Surfaces the “you’ve been invited — finish registering” UX loop.

Driver: auction_user_relation.email = current_user.email AND userId IS NULL AND isInvited = 1 AND isDeleted = 0. Email match is case- and accent-insensitive (DB collation utf8mb4_0900_ai_ci).

Already-registered auctions (non-deleted aur with isBidder = 1 for this user) are filtered out — no double-listing in my-auctions + invited-auctions.

Same lean card shape as /v3/auctions (no featured items, no paddle number). Use this in parallel with my-auctions on home-screen load.

401 if token missing/invalid. Empty array if the user has no email on file or no matching invitations.

Authorizations

bearer

Parameters

Query Parameters

limit

integer

Default 3, range 1-100

Example

whitelabelId

string

1 = all public whitelabels

Example

{{whitelabelId}}

Responses

200

Successful response

application/json