Ask AI or search...
Get API Keys

Update a beneficial owner #

This endpoint can be used to update a beneficial owner's information to retry verification. A beneficial owner's information can only be updated if their verification status is incomplete.

HTTP request #

POST https://api.dwolla.com/beneficial-owners/{id}

Request Parameters #

ParameterRequiredTypeDescription
firstNameyesstringThe legal first name of the beneficial owner. Must be ≤ 50 characters and cannot contain special characters [<>="`!?%~${}\].
lastNameyesstringThe legal last name of the beneficial owner. Must be ≤ 50 characters and cannot contain special characters [<>="`!?%~${}\].
ssnconditionalstringFull nine digits of the beneficial owner’s social security number. If SSN is omitted, passport is required.
dateOfBirthyesstringBeneficial owner’s date of birth in YYYY-MM-DD format. Must be between 18 to 125 years of age.
addressyesobjectAn address JSON object. Full address of the beneficial owner's physical address.
passportconditionalobjectAn optional passport JSON object. Required for non-US persons. Includes passport identification number and country. If passport is omitted, SSN is required.

Address JSON object #

ParameterRequiredTypeDescription
address1yesstringFirst line of the street address of the Beneficial Owner's permanent residence.
PO Boxes are not allowed.
Must be ≤ 50 characters and contain no special characters [<>="`!?%~${}\].
address2nostringSecond line of the street address.
PO Boxes are not allowed.
Must be ≤ 50 characters and contain no special characters [<>="`!?%~${}\].
address3nostringThird line of the street address.
PO Boxes are not allowed.
Must be ≤ 50 characters and contain no special characters [<>="`!?%~${}\].
cityyesstringCity of the Beneficial Owner's permanent residence.
Must be ≤ 50 characters.
Cannot contain numbers or special characters [<>="`!?%~${}\].
stateProvinceRegionyesstringUS persons - Two-letter US state abbreviation of the Beneficial Owner's physical address. See the US Postal Service guide.
Non-US persons - Two-letter state, province, or region ISO abbreviation.
If no two-letter abbreviation exists, use the country’s ISO 2-letter abbreviation.
Must be uppercase (e.g., CA).
countryyesstringCountry of the Beneficial Owner's permanent residence.
Two-digit ISO country code (e.g., US for United States, CA for Canada). See the ISO country codes list.
postalCodeconditionalstringPostal code of the Beneficial Owner’s permanent residence.
US persons must provide a 5-digit ZIP code (e.g., 50314).
Non-US persons - Optional, but may include alphanumeric postal codes where applicable.

Passport JSON object #

ParameterRequiredTypeDescription
numberconditionalstringRequired if Beneficial Owner resides outside of the United States and has no Social Security Number.
Must be ≤ 255 characters and contain no special characters [<>="`!?%~${}\].
countryconditionalstringCountry of issued passport.
Two-digit ISO country code (e.g., US for United States, CA for Canada).
Must be 2 characters (ISO standard).

HTTP status and error codes #

HTTP StatusMessage
200Owner Updated.
400Validation error.
403Owner cannot be updated.
404Owner not found.

Request and response #

Raw
POST https://api-sandbox.dwolla.com/beneficial-owners/07d59716-ef22-4fe6-98e8-f3190233dfb8
Content-Type: application/vnd.dwolla.v1.hal+json
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY

{
  "firstName": "beneficial",
  "lastName": "owner",
  "ssn": "123-54-6789",
  "dateOfBirth": "1963-11-11",
  "address": {
    "address1": "123 Main St.",
    "address2": "Apt 123",
    "city": "Des Moines",
    "stateProvinceRegion": "IA",
    "country": "US",
    "postalCode": "50309"
  }
}

...

{
    "_links": {
        "self": {
            "href": "https://api-sandbox.dwolla.com/beneficial-owners/07d59716-ef22-4fe6-98e8-f3190233dfb8",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "beneficial-owner"
        }
    },
    "id": "00cb67f2-768c-4ee3-ac81-73bc4faf9c2b",
    "firstName": "beneficial",
    "lastName": "owner",
    "address": {
        "address1": "123 Main St.",
        "address2": "Apt 123",
        "city": "Des Moines",
        "stateProvinceRegion": "IA",
        "country": "US",
        "postalCode": "50309"
    },
    "verificationStatus": "verified"
}
Test in the Sandbox for free today.
Use sandbox environment to test API requests.
Get API Keys
2025 All Rights Reserved
Financial institutions play an important role in our network.

All funds transfers made using the Dwolla Platform are performed by a financial institution partner, and any funds held in a Dwolla Balance are held by a financial institution partner. Learn more about our financial institution partners.