Remove a Beneficial Owner
Removes a beneficial owner from the business. As in v2, the owner's status does not matter: one already approved can be removed too. Removing an owner that is already gone, or that belongs to another business, answers 404.
Takes a workspace-scoped API key or a dashboard session. An account-scoped key is refused with 401.
Replaces DELETE /api/v2/kyb/banking-verification/business/ownership/{ownerId}.
Authorization:
Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.
Headers:
Authorization: APIKey {SIGNED_JWT}
How to build and sign the JWT: Authentication.
Endpoint
/v3/customers/{customer_id}/kyb/owners/{owner_id}
Path parameters
| Parameter | Type | Description |
|---|---|---|
customer_id | string (cst_…) | Required. The business customer. |
owner_id | string (kyc_…) | Required. The owner, from List Beneficial Owners. |
Response
204 No Content, with no body.
Errors
| Status | message | When |
|---|---|---|
400 | failed to parse request | customer_id is not a cst_… TypeID, or owner_id is not a kyc_… TypeID. |
401 | unauthorized | Missing or invalid signature, or an account-scoped key or customer session. |
403 | forbidden | A dashboard member whose role does not allow this. A workspace-scoped key always may. |
404 | customer_not_found | No such customer in the workspace. |
404 | kyb_not_found | This customer has no record. |
404 | kyb_owner_not_found | No such owner on this business, or it was already removed. |
Coming from v2
v2 (DELETE …/business/ownership/{ownerId}) | v3 |
|---|---|
ownerId (path, uuid) | customer_id (cst_…) and owner_id (kyc_…), both in the path |
| the owner is named on its own | the owner is named under its business; another business's owner answers 404 kyb_owner_not_found |
Support and Resources
If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.
Stay Updated
Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:
- Instagram: BlockWyre Instagram
- Twitter: BlockWyre Twitter
- Facebook: BlockWyre Facebook
- LinkedIn: BlockWyre LinkedIn
We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!