GET /v3/auction/:id/items — subsequent page

GET

/v3/auction/{auctionId}/items

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

NEW (HAN-1685). offset > 0 returns ONLY {auctionStatus, endTime, items, totalCount} — no categories[] and no featuredItems[] (those don’t change between pages, so subsequent pages skip them to save bandwidth).

auctionStatus + endTime ride along on every page so the client can detect staleness without a separate auction-state poll.

Authorizations

bearer

Parameters

Path Parameters

auctionId

required

string

Query Parameters

limit

integer

Example

offset

integer

Example

Responses

200

Successful response

application/json