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 #

Parameter	Required	Type	Description
firstName	yes	string	The legal first name of the beneficial owner.
lastName	yes	string	The legal last name of the beneficial owner.
ssn	conditional	string	Full nine digits of beneficial owner’s social security number. If ssn is omitted, passport is required.
dateOfBirth	Yes	string	beneficial owner’s date of birth in `YYYY-MM-DD` format. Must be between 18 to 125 years of age.
address	Yes	object	An address JSON object. Full address of the beneficial owner's physical address.
passport	conditional	object	An optional passport JSON object. Required for non-US persons. Includes passport identification number and country.

Address JSON object #

Parameter	Required	Type	Description
address1	yes	string	First line of the street address of the beneficial owner's permanent residence. Note: PO Boxes are not allowed.
address2	no	string	Second line of the street address of the beneficial owner's permanent residence. Note: PO Boxes are not allowed.
address3	no	string	Third line of the street address of the beneficial owner's permanent residence. Note: PO Boxes are not allowed.
city	yes	string	City of beneficial owner's permanent residence.
stateProvinceRegion	yes	string	Two-letter US state or territory abbreviation code of beneficial owner’s physical address. For two-letter abbreviation reference, check out the US Postal Service guide.
country	yes	string	Country of beneficial owner's permanent residence. Two digit ISO code, e.g. `US`.
postalCode	yes	string	Postal code of beneficial owner's permanent residence. Should be a five digit postal code, e.g. `50314`.

Passport JSON object #

Parameter	Required	Type	Description
number	conditional	string	Required if beneficial owner is a non-US person and has no Social Security number.
country	conditional	string	Country of issued passport.

HTTP status and error codes #

HTTP Status	Message
200	Owner Updated.
400	Validation error.
403	Owner cannot be updated.
404	Owner 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"
}

List beneficial owners

Remove a beneficial owner

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys

Dwolla

Product

Developers

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.