Docs
Get API Keys
All Docs
API Reference
  • Authorization
    Root
    Accounts
    External Parties
    Funding Sources
    Transfers
    Webhook Subscriptions
    Webhooks
Get API Keys

Create a document for a beneficial owner #

Create a document for a beneficial owner pending verification by uploading a photo of the document. This requires a multipart form-data POST request. The file must be either a .jpg, .jpeg, or .png, up to 10MB in size.

HTTP request #

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

Request parameters #

Form FieldDescription
documentTypeOne of passport, license, idCard, or other
fileFile contents.

Request and response #

Raw
curl -X POST
\ -H "Authorization: Bearer tJlyMNW6e3QVbzHjeJ9JvAPsRglFjwnba4NdfCzsYJm7XbckcR"
\ -H "Accept: application/vnd.dwolla.v1.hal+json"
\ -H "Cache-Control: no-cache"
\ -H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"
\ -F "documentType=passport"
\ -F "file=@foo.png"
\ 'https://api-sandbox.dwolla.com/beneficial-owners/1de32ec7-ff0b-4c0c-9f09-19629e6788ce/documents'

...

HTTP/1.1 201 Created
Location: https://api-sandbox.dwolla.com/documents/11fe0bab-39bd-42ee-bb39-275afcc050d0
Test in the Sandbox for free today.
Use sandbox environment to test API requests.
Get API Keys
2023 All Rights Reserved

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.