Delete a beneficial owner

Remove a beneficial owner from a business customer. The owner’s uploaded documents are deleted with them, and the customer’s verification status is recomputed without this owner. The request is rejected while a verification review that includes this owner is in progress; wait for the review to finish and retry.

DELETE /beneficial-owners/{beneficialOwnerId}

Delete a beneficial owner

cURL

curl --request DELETE \
  --url https://api.lightspark.com/grid/2025-10-13/beneficial-owners/{beneficialOwnerId} \
  --header 'Authorization: Basic <encoded-value>'

401

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Path Parameters

beneficialOwnerId · string · required

Beneficial owner ID

Response

204

Beneficial owner deleted successfully