Owners (business customers)

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.

DELETEapi-prod.blaaiz.com/api/external/customer/{customer}/owner/{owner}

Authorization

oauth2ClientCredentials customer:write
AuthorizationBearer <token>

Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.

In: header

Scope: customer:write

Path Parameters

customer*string
Formatuuid
owner*string
Formatuuid

Response Body

application/json

application/json

Delete a customer owner
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`.