---
title: "Certify beneficial ownership"
method: POST
path: "/customers/{id}/beneficial-ownership"
tags: ["beneficial owners"]
---

# Certify beneficial ownership

`POST /customers/{id}/beneficial-ownership`

Updates the beneficial ownership certification status to "certified", confirming that all beneficial owner information is accurate and complete. This action enables the business customer to send funds and is required to complete the verification process.

## Path parameters

- `id` string, required

## Headers

- `Accept` 'application/vnd.dwolla.v1.hal+json', required

## Request body

- object
  - `status` string, required

## Response `200`

successful operation

## Other responses

- `400` — ValidationError
- `403` — forbidden

## Changes

- **2025-11-19** `e44b6a6d5724` — 3 warning, 2 info
  - added the new `certified` enum value to the `status` response property for the response status `200`
  - added the new `recertify` enum value to the `status` response property for the response status `200`
  - added the new `uncertified` enum value to the `status` response property for the response status `200`
  - the response property `_links` became required for the status `200`
  - …1 more
- **2025-06-06** `231d0268586b` — 1 breaking, 2 info
  - request body became required
  - the response property `code` became required for the status `400`
  - the response property `message` became required for the status `400`
- **2025-05-23** `4c8b16e05918` — 1 breaking
  - added the new required `header` request parameter `Accept`

[Change history](https://skmtc.dev/dwolla/apis/dwolla-api/changes/customers/:id/beneficial-ownership/post.md)

---

[API](https://skmtc.dev/dwolla/apis/dwolla-api.md) · [All operations](https://skmtc.dev/dwolla/apis/dwolla-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dwolla/apis/dwolla-api/revisions/7877985e14b4?raw)