Certify beneficial ownership #

This section contains information on how to certify beneficial ownership for a business Verified Customer.

HTTP request #

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

Request parameters #

Parameter	Required	Type	Description
id	yes	string	Customer unique identifier.

HTTP status and error codes #

HTTP Status	Message
200	Beneficial ownership status updated.
400	Validation error.
403	Forbidden from updating beneficial ownership status for this customer.

Request and response #

Raw

POST https://api-sandbox.dwolla.com/customers/56502f7a-fa59-4a2f-8579-0f8bc9d7b9cc/beneficial-ownership
Accept: application/vnd.dwolla.v1.hal+json
Content-Type: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY

{
  "status": "certified"
}

...

{
    "_links": {
        "self": {
            "href": "https://api-sandbox.dwolla.com/customers/56502f7a-fa59-4a2f-8579-0f8bc9d7b9cc/beneficial-ownership",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "beneficial-ownership"
        }
    },
    "status": "certified"
}

Retrieve beneficial ownership status

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.