documents

List documents for beneficial owner

Returns all identity verification documents submitted for a beneficial owner. Includes document status, verification results, document type (passport, driver's license, etc.), and failure reasons if verification was rejected. Used to track document submission and verification progress during the business verification process.

get/beneficial-owners/{id}/documents

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

Response

successful operation

Changes

Changed in 3 of the 33 revisions of this API.1914

Nov 19, 2025e44b6a6d5724912See the full diff
- ●
  added the new accepted enum value to the _embedded/documents/items/documentVerificationStatus response property for the response status 200
  response-property-enum-value-added
- ●
  added the new idCard enum value to the _embedded/documents/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new license enum value to the _embedded/documents/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new other enum value to the _embedded/documents/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new passport enum value to the _embedded/documents/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new pending enum value to the _embedded/documents/items/documentVerificationStatus response property for the response status 200
  response-property-enum-value-added
- ●
  added the new pending enum value to the _embedded/documents/items/status response property for the response status 200
  response-property-enum-value-added
- ●
  added the new rejected enum value to the _embedded/documents/items/documentVerificationStatus response property for the response status 200
  response-property-enum-value-added
- ●
  added the new reviewed enum value to the _embedded/documents/items/status response property for the response status 200
  response-property-enum-value-added
- ○
  the response property _embedded became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents/items/_links became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents/items/allFailureReasons/items/description became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents/items/allFailureReasons/items/reason became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents/items/created became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents/items/documentVerificationStatus became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents/items/id became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents/items/status became required for the status 200
  response-property-became-required
- ○
  the response property _embedded/documents/items/type became required for the status 200
  response-property-became-required
- ○
  the response property _links became required for the status 200
  response-property-became-required
- ○
  the response property total 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
Jun 6, 2025231d0268586b2See the full diff
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the non-success response with the status 404
  response-non-success-status-added
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