since 1999

Home / Documentation / API / Identity documents

API reference · 18.08.2026

Identity documents

Upload, list and remove the signed-in bidder's identity and company documents.

GET /v1/me/documents

Identity and company documents the caller has uploaded.

Api-Key headermember token

Signed-in member. Send the token from POST /v1/sessions. Always send Api-Key as well.

Responses

StatusMeaningBody
200OK
POST /v1/me/documents

Uploads an identity or company document for the caller.

Api-Key headermember token

Auction houses often require proof of identity, or company registration for business buyers, before a bidder registration is approved. This is where that document goes.

The document is always filed against the signed-in member — any address in the body isignored, so a member can only ever upload for themselves. List what has been uploaded with GET /v1/me/documents and remove one withDELETE /v1/me/documents/{id}. Uploading does not approve anything; approval is aback-office decision and is reported through the auction registration status.

Request body · application/json · AddMemberFileRequest

PropertyTypeRequired
Emailstringno
MemberUploadFilesarray of MemberUploadFilesno

MemberUploadFiles

PropertyTypeRequired
Namestringno
ContentTypestringno
Datastring (byte)no

Responses

StatusMeaningBody
200OKHttpResponseMessage
DELETE /v1/me/documents/{id}

Removes one of the caller's own documents.

Api-Key headermember token

Signed-in member. Send the token from POST /v1/sessions. Always send Api-Key as well.

Parameters

NameInTypeRequired
idpathstring (uuid)yes

Responses

StatusMeaningBody
200OK