Certify beneficial ownership for a client
POST https://api-sandbox.dwolla.com/clients/{{clientAccountId}}/beneficial-ownership
Certify beneficial ownership for a Client Account.
Request parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| id | yes | string | Client Account Unique Identifier. |
HTTP status and error codes
| HTTP Status | Code | Message | Description |
|---|---|---|---|
| 200 | Ok | Success | Beneficial ownership was successfully certified. |
| 400 | BadRequest | Validation error(s) present. See embedded errors list for more details. | An error exists with the request. Check the embedded list of errors for more detailed error messages. Also check Validation Errors section in the API reference. |
| 403 | InvalidResourceState | Resource cannot be modified. | Forbidden from updating beneficial ownership status for this client. |
| 404 | NotFound | The requested resource was not found. | Client Account not found. Check Client Account Id. |
Request Body
{"status"=>"certified"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string | ||
Authorization | string |
RESPONSES
status: OK
{"_links":{"self":{"href":"https://api-sandbox.dwolla.com/clients/02585eb7-683a-4872-addd-fbafc6e9fcf7/beneficial-ownership","type":"application/vnd.dwolla.v1.hal+json","resource-type":"beneficial-ownership"}},"status":"certified"}