Declare the beneficial owners

POST/v1/kyb/cases/{id}/declaration

Beneficial owners (ownership of 25% or more, or other control) or, where none can be identified, the controlling persons (management). Declared owners with an email or phone get a verification link when the workflow verifies beneficial owners. The applicant can also use the case's declaration_url. Needs kyb:write.

Send your API key in the x-api-key header.

Path parameters

idstringuuidrequired

Request bodyapplication/jsonrequired

kindanyrequired
One ofbeneficial_ownerscontrolling_persons
personsarray of object1–25 itemsrequired
Show 8 child propertiesHide child properties
- namestringrequired
- date_of_birthstringdate
- nationalitystring
  ISO 3166-1 alpha-3
- addressstring
- ownership_pctnumber0–100
- controlanyrequired
  One ofownershipother_controlmanagement
- emailstring
- phonestring
signerobjectrequired
Show 2 child propertiesHide child properties
- namestringrequired
- functionstring
confirmedbooleanalways truerequired

Responses

201Received: declaration_id and the invitations sent.
400Invalid declaration.
404No such case.
409The case is closed or its company was not found.

curl -X POST https://api-verify.secuveri.com/v1/kyb/cases/6f1c2e0a-8f43-4f7e-9a51-2b7c1d9e4a10/declaration \
  -H "x-api-key: $SECUVERI_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "kind": "beneficial_owners",
  "persons": [
    {
      "name": "Jane Doe",
      "control": "ownership"
    }
  ],
  "signer": {
    "name": "Jane Doe"
  },
  "confirmed": true
}'