beneficial owners

Update beneficial owner

Updates a beneficial owner's information to retry verification when their status is "incomplete". Only beneficial owners with incomplete verification status can be updated. Used to correct information that caused initial verification to fail.

post/beneficial-owners/{id}

Path parameters

idstring required

Beneficial owner unique identifier

Headers

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

The media type of the response. Must be application/vnd.dwolla.v1.hal+json

Request body

Example request

{
  "firstName": "John",
  "lastName": "Doe",
  "dateOfBirth": "1980-01-31",
  "address": {
    "address1": "462 Main Street",
    "address2": "Suite 123",
    "address3": "Unit 123",
    "city": "Des Moines",
    "postalCode": "50309",
    "country": "USA",
    "stateProvinceRegion": "IA"
  },
  "ssn": "123456789"
}

Response

successful operation

Changes

Changed in 4 of the 33 revisions of this API.3310

Nov 19, 2025e44b6a6d572437See the full diff
- ●
  added the new document enum value to the verificationStatus response property for the response status 200
  response-property-enum-value-added
- ●
  added the new incomplete enum value to the verificationStatus response property for the response status 200
  response-property-enum-value-added
- ●
  added the new verified enum value to the verificationStatus response property for the response status 200
  response-property-enum-value-added
- ○
  the response property _links became required for the status 200
  response-property-became-required
- ○
  the response property address became required for the status 200
  response-property-became-required
- ○
  the response property created became required for the status 200
  response-property-became-required
- ○
  the response property firstName became required for the status 200
  response-property-became-required
- ○
  the response property id became required for the status 200
  response-property-became-required
- ○
  the response property lastName became required for the status 200
  response-property-became-required
- ○
  the response property verificationStatus became required for the status 200
  response-property-became-required
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 1, 20258a20e700064511See the full diff
- ▲
  removed BeneficialOwnerWithSsn BeneficialOwnerWithPassport from the request body oneOf list
  request-body-one-of-removed
- ○
  added CreateUSBeneficialOwner CreateInternationalBeneficialOwner to the request body oneOf list
  request-body-one-of-added
This revision also has 23 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 6, 2025231d0268586b12See the full diff
- ▲
  request body became required
  request-body-became-required
- ○
  the response property code became required for the status 400
  response-property-became-required
- ○
  the response property message became required for the status 400
  response-property-became-required
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 23, 20254c8b16e059181See the full diff
- ▲
  added the new required header request parameter Accept
  new-required-request-parameter

Full history