Docs
Get API Keys

Create a document for a beneficial owner #

To verify an individual's identity, please upload a clear, colored image of a government-issued identification document captured with a camera.

Here's what you need to know about uploading a document:

  • Multipart Form-Data POST Request: You'll need to use a multipart form-data POST request to upload your document. This is a specific type of HTTP request used for file uploads.
  • Supported File Formats: The uploaded file must be a color image in one of these formats: JPG, JPEG, or PNG.
  • File Size Limit: The file size cannot exceed 10MB.

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
2024 All Rights Reserved
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.