since 1999

Home / Documentation / API / Categories

API reference · 18.08.2026

Categories

The category tree, a single category, and the categories present in one auction.

GET /v1/categories

The category tree.

Api-Key headeranonymous token

Anonymous. No sign-in, but this shared host cannot tell which auction house you mean, so it needs a tenant token from POST /v1/tokens/anonymous. Always send Api-Key as well.

Parameters

NameInTypeRequired
showAll
Include categories with no lots in them.
querybooleanno

Responses

StatusMeaningBody
200OK
GET /v1/categories/{id}

A single category.

Api-Key headeranonymous token

Anonymous. No sign-in, but this shared host cannot tell which auction house you mean, so it needs a tenant token from POST /v1/tokens/anonymous. Always send Api-Key as well.

Parameters

NameInTypeRequired
idpathinteger (int32)yes

Responses

StatusMeaningBody
200OK
GET /v1/auctions/{id}/categories

The categories that appear in one auction.

Api-Key headeranonymous token

Anonymous. No sign-in, but this shared host cannot tell which auction house you mean, so it needs a tenant token from POST /v1/tokens/anonymous. Always send Api-Key as well.

Parameters

NameInTypeRequired
idpathinteger (int32)yes

Responses

StatusMeaningBody
200OK