Sellers

Use sellers to reconcile an import’s seller number with the house’s existing seller profiles. These endpoints are read-only and require seller_profiles.read.

Paths are relative to /api/v2. All results belong to the API key’s house. Archived seller profiles are excluded.

{
  "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 the seller profile’s name, falling back to its linked account only within the same house. It can be null. Bank details, addresses and private comments are not included. Timestamps describe the seller profile record; a linked account’s name can change independently of updated_at.

Find a seller number

Request /api/v2/sellers?seller_number=1000. The filter accepts a signed 32-bit whole integer and matches exactly. It is a business reference, not a public ID.

Follow pagination through all results. Historical duplicates can exist: zero matches means no active match, while multiple matches require explicit reconciliation. Do not silently choose the first result.

Both endpoints use the standard data envelope. The list also supports limit and cursor; a cursor belongs to its original house and filters. Show rejects collection filters. Neither endpoint supports expansions. A record without a valid public identity returns a 500 Problem Details response; reads never invent an ID or repair stored data.