Overview

Use this method to unlink a beneficiary applicant from the control and ownership structure of the company, provided the company applicant relates to the KYB 2.0 flow.

Request example

curl -X DELETE \
     'https://api.sumsub.com/resources/applicants/673f390478c5cc60a492aa39/fixedInfo/companyInfo/beneficiaries/27b45216-eb19-43db-a4ad-c5cd2d184616'

Response explained

If the request is successfully sent and processed, you will get the following response indicating the beneficiary has been unlinked from the control and ownership structure of the company:

{
  "ok": 1
}

If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error. For example:

{
  "description": "Company beneficiary not found 673f44507b66912172318b43",
  "code": 404,
  "correlationId": "4de03a9f0a593b9d5a6eeb78d4d4ba88"
}