Removes a beneficial owner from the customer. Returns 400 if the owner is locked (status APPROVED or PROCESSING). Required scope: customer:write.
Note: owners can also be created and edited as part of POST /api/external/customer and PUT /api/external/customer/{id} via the owners array — only deletion has its own dedicated endpoint.
Authorization
oauth2ClientCredentials customer:writeUse your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.
In: header
Scope: customer:write
Path Parameters
uuiduuidResponse Body
application/json
application/json
curl --request DELETE \ --url 'https://example.com/api/external/customer/497f6eca-6276-4993-bfeb-53cbbbba6f08/owner/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "message": "Owner deleted successfully"}POSTRegister owner ID files
Register one or both of the owner's ID document slots (`id_document_front`, `id_document_back`). Each `file_id` must come from a fresh `POST /api/external/customer/{customer}/owner/{owner}/file/presigned-url` call. Send only the slots you want to set or replace. **Lock guards.** - The parent customer must be in `PENDING` or `REJECTED`. Calls against a `PROCESSING` or `VERIFIED` customer return `400`. - The owner itself must be in `PENDING` or `REJECTED`. Calls against an `APPROVED` or `PROCESSING` owner return `400`. - Replacing a file on a previously `REJECTED` owner automatically resets that owner's `status` to `PENDING` and clears its `admin_comments` — the corrected record is re-routed through review on the next `/submit`. **File checks.** The server verifies S3 existence, file size (max 25 MB), and MIME type (PDF, JPEG, or PNG) before persisting. **Slot vs. type consistency** is enforced at `/submit` time, not on this call. The eventual rule is: - `passport` → `id_document_front` only; `id_document_back` must be absent. - `drivers_license`, `id_card`, `resident_permit` → both `id_document_front` and `id_document_back` are required. If you change the owner's `id_document_type` later, make sure the slot set still matches — otherwise `/submit` will reject the customer. All uploaded documents must be **clear, legible, and authentic**. Blurry, cropped, obscured, or otherwise unclear images will be rejected. Fraudulent or falsified documents will not be tolerated — repeated attempts to submit false or invalid documents will result in the customer being **permanently blacklisted** from the platform. There are no exceptions or compromises. Required scope: `customer:write`.
GETList beneficiaries
Retrieve all beneficiaries for a customer. Required scope: `beneficiary:read`.