Retrieve beneficial ownership status #

This section contains information on how to retrieve a Customer's beneficial ownership status.

HTTP request #

GET 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	Ownership certification status found.
403	Not authorized to get certification status.
404	Ownership certification status not found.

Request and response #

Raw

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

...

{
    "_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": "uncertified"
}

Remove a beneficial owner

Certify beneficial ownership

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.