since 1999

Home / Documentation / API / Bidder profile

API reference · 18.08.2026

Bidder profile

Retrieve and update the signed-in bidder's own profile.

GET /v1/me

The signed-in member's own profile.

Api-Key headermember token

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

Responses

StatusMeaningBody
200OK
PUT /v1/me

Replaces the signed-in member's own profile.

Api-Key headermember token

<b>A replacement, not a merge — send the complete profile.</b> Every field in the body is written, so a field you leave out is stored as empty rather than left alone. Read the profile with GET /v1/me, change what you need, and send the whole object back.

The member is taken from your token, so the body identifies nobody and a member can only ever update themselves. Changing CompanyName or VATNumber triggers a VAT check, which can alter whether the member is charged VAT on future invoices — re-read the profile afterwards rather than assuming what you sent is what was stored.

Request body · application/json · MemberDto

PropertyTypeRequired
UIDstring (uuid)no
Idinteger (int32)no
DateRegisteredstring (date-time)no
Emailstringno
IsConsignerbooleanno
HasBidderRolebooleanno
Rolesarray of stringno
DateOfBirthstring (date-time)no
Languagestringno
Validatedbooleanno
FirstNamestringno
LastNamestringno
Titlestringno
Genderstringno
IsCompanybooleanno
CompanyNamestringno
CompanyIdstringno
CompanyRegistrationCitystringno
VATNumberstringno
Addressstringno
HouseNumberstringno
AddressSecondstringno
ZipCodestringno
Citystringno
Countrystringno
Faxstringno
Phonestringno
Phone2stringno
FoundByinteger (int32)no
LoginProviderstringno
ProviderKeystringno
ExternalLoginbooleanno
RegistrationTypeinteger (int32)no
MailingListsstringno
FoundByOtherstringno
IdentificationTypestringno
IdentificationValuestringno
PaymentOptionIdinteger (int32)no
PaymentOptionValuestringno
PaymentExtraDatastringno
ExtraDataobjectno
IpAddressstringno
Createdstring (date-time)no
VatFreebooleanno
IsPepbooleanno
Websitestringno
SmsVerificationCompletedbooleanno
DeliveryNamestringno
DeliveryAddressstringno
DeliveryHouseNumberstringno
DeliveryAddressSecondstringno
DeliveryZipCodestringno
DeliveryCitystringno
DeliveryCountrystringno
DeliveryPhonestringno
FullNamestringno
FullNameWithIdstringno
ValidationKeystringno
Timezonestringno
ApplicationNamestringno
ApplicationIdstring (uuid)no

Responses

StatusMeaningBody
200OKHttpResponseMessage