Skip to content
Handbid Developers

GET /v3/auction/{auctionId}/categories — category list + timers

GET
/v3/auction/{auctionId}/categories
 
curl --request GET \
  --url 'https://api-ha-prod-p8.handbid.dev/v3/auction/33934/categories?sort=default' \
  --header 'Authorization: Bearer <token>'

Slim, identity-free categories payload for the category-browse UI: {auctionStatus, endTime, categories[]}, each category {id, name, itemCount, status, timerStartTime, closingTime}.

sort: default (native order) or name (legacy web order). Unknown sort → 400. Category sorts and item sorts are separate vocabularies.

Auth: optional (identity-free; token only feeds the visibility gate + limiter).

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
auctionId
required
integer
Example 
33934

Query Parameters

Section titled “Query Parameters ”
sort
string
Allowed values: default name

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Categories + timers.

Media type application/json
object
Example generated
{}

400

Section titled “400 ”

Validation error.

Media type application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object
error
required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string
message
required

Human-readable explanation.

string
retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer
Example generated
{
  "error": "example",
  "message": "example",
  "retryAfter": 1
}

403

Section titled “403 ”

Private event — invitation code required (private_event_pin_required); exchange it at the access route.

Media type application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object
error
required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string
message
required

Human-readable explanation.

string
retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer
Example generated
{
  "error": "example",
  "message": "example",
  "retryAfter": 1
}

404

Section titled “404 ”

Not found (unknown id/key, or a privacy-blocked auction — a 403 would assert existence).

Media type application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object
error
required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string
message
required

Human-readable explanation.

string
retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer
Example generated
{
  "error": "example",
  "message": "example",
  "retryAfter": 1
}

429

Section titled “429 ”

Rate limited; Retry-After seconds.

Media type application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object
error
required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string
message
required

Human-readable explanation.

string
retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer
Example generated
{
  "error": "example",
  "message": "example",
  "retryAfter": 1
}