Home / Documentation / API / Auctions
API reference · 18.08.2026
Retrieve an auction, list auctions by status, download the catalogue or a spreadsheet export, fetch translated copy, record acceptance of the terms.
/v1/auctions/{id}A single auction./v1/auctionsAuctions, filtered by status./v1/auctions/{id}/catalogueThe auction catalogue as a PDF./v1/auctions/{id}/exportThe auction's lots as a spreadsheet./v1/auctions/{id}/translationsTranslated copy for one auction./v1/auctions/{id}/terms-acceptanceRecords the caller's acceptance of an auction's terms./v1/auctions/{id}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.
| Name | In | Type | Required |
|---|---|---|---|
id | path | integer (int32) | yes |
| Status | Meaning | Body |
|---|---|---|
200 | OK | — |
/v1/auctionsApi-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.
| Name | In | Type | Required |
|---|---|---|---|
statusAuction status to list, e.g. current or closed. | query | string | no |
page1-based page number. | query | integer (int32) | no |
pageSizeOmit to use the tenant's configured page size. | query | integer (int32) | no |
| Status | Meaning | Body |
|---|---|---|
200 | OK | — |
/v1/auctions/{id}/catalogueApi-Key headeranonymous token
Opened with a plain link, so language comes from ?lang= where a browser cannot be
made to send Accept-Language.
| Name | In | Type | Required |
|---|---|---|---|
id | path | integer (int32) | yes |
| Status | Meaning | Body |
|---|---|---|
200 | OK | — |
/v1/auctions/{id}/exportApi-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.
| Name | In | Type | Required |
|---|---|---|---|
id | path | integer (int32) | yes |
| Status | Meaning | Body |
|---|---|---|
200 | OK | — |
/v1/auctions/{id}/translationsApi-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.
| Name | In | Type | Required |
|---|---|---|---|
id | path | integer (int32) | yes |
| Status | Meaning | Body |
|---|---|---|
200 | OK | — |
/v1/auctions/{id}/terms-acceptanceApi-Key headermember token
Send this once the member has agreed to the auction's terms and conditions. There is no request body — the auction comes from the URL and the member from your token.
Some auctions require accepted terms before a registration request will be granted; theterms themselves are among the documents returned byGET /v1/auctions/{id}/documents. Sending it twice is harmless.
| Name | In | Type | Required |
|---|---|---|---|
idThe auction whose terms are being accepted. | path | integer (int32) | yes |
| Status | Meaning | Body |
|---|---|---|
200 | Acceptance recorded. | — |
401 | No member token, or the member no longer exists. | — |