Inbrengers

Gebruik deze endpoints om de inbrengersnummers uit een import te koppelen aan bestaande inbrengerprofielen. Ze zijn alleen-lezen en vereisen seller_profiles.read.

EndpointDoel
GET /sellersActieve inbrengerprofielen opvragen; optioneel filteren op seller_number
GET /sellers/{id}Eén inbrengerprofiel opvragen

Paden zijn relatief aan /api/v2. Alle resultaten horen bij het veilinghuis van de API-sleutel. Gearchiveerde inbrengerprofielen worden niet teruggegeven.

{
  "id": "sel_b48e0a19-5c72-4d83-91af-3e6b2c07d514",
  "seller_number": 1000,
  "name": "Jan de Vries",
  "created_at": "2026-05-20T14:02:00Z",
  "updated_at": "2026-07-05T19:08:11Z"
}

name is de naam uit het inbrengerprofiel, met als terugval de gekoppelde account binnen hetzelfde veilinghuis. De waarde kan null zijn. Bankgegevens, adressen en privéopmerkingen ontbreken. De tijdstempels horen bij het inbrengerprofiel; de naam van een gekoppelde account kan wijzigen zonder dat updated_at verandert.

Zoeken op inbrengersnummer

Vraag /api/v2/sellers?seller_number=1000 op. Het filter accepteert een geheel getal binnen het bereik van een signed 32-bit integer en zoekt een exacte overeenkomst. Het nummer is een bedrijfsreferentie, geen publieke ID.

Volg de paginering door alle resultaten. Historische dubbele nummers kunnen bestaan: nul resultaten betekent geen actieve overeenkomst, meerdere resultaten moeten expliciet worden beoordeeld. Kies niet stilzwijgend het eerste resultaat.

Beide endpoints gebruiken de standaard data-envelop. De lijst ondersteunt ook limit en cursor; een cursor hoort bij het oorspronkelijke veilinghuis en de oorspronkelijke filters. Het detailendpoint weigert lijstfilters. Beide endpoints ondersteunen geen expansies. Een record zonder geldige publieke identiteit geeft een 500 Problem Details-antwoord; leesverzoeken verzinnen geen ID en herstellen geen opgeslagen gegevens.