DocsCreate a document for a customer #
To verify an individual or business identity, please upload a clear, colored image captured with a camera of a government-issued identification document. Reference the table below for the list of acceptable documents.
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. Business Documents in PDF format are accepted for verification purposes.
- File Size Limit: The file size cannot exceed 10MB.
Acceptable documents #
| Customer type | Acceptable documents |
|---|---|
| Personal Verified Customer | passport, license, or idCard. Must be a colored camera captured image of a U.S. government-issued identification. Foreign passports will be rejected with ForeignPassportNotAllowed if uploaded for this customer type. |
| Business Verified Customer | Controller documents - passport, license, or idCard.
other. Refer to our guide on Handling Document status for Business Verified Customers for acceptable documents. |
HTTP request #
POST https://api.dwolla.com/customers/{id}/documents
Request Parameters #
| Form Field | Description |
|---|---|
| documentType | Acceptable values of: passport, license, idCard, or other. Refer to the acceptable documents section for more information on how these document types apply to each Customer type. |
| file | File contents. |
HTTP status and error codes #
| HTTP Status | Code | Description |
|---|---|---|
| 201 | Created | A document resource was created. |
| 400 | maximumNumberOfResources | Max of four files upload allowed. Please wait for Dwolla to manually check the documents. |
| 400 | invalidFileType | File types supported: Personal IDs - .jpg, .jpeg or .png. Business Documents - .jpg, .jpeg, .png, or .pdf. |
| 400 | DuplicateResource | Document already exists. Follow the link to find the existing document for the Customer. |
| 403 | invalidResourceState | Resource cannot be modified. Document creation not allowed for already verified Customers or non-verified Customer types. |
| 403 | notAuthorized | Not authorized to create documents. |
| 404 | notFound | Customer not found. Check CustomerId. |
| 413 | fileTooLarge | Document requests are limited to 10 MiB. |
Request and response #
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/customers/1de32eC7-ff0b-4c0c-9f09-19629e6788ce/documents'
...
HTTP/1.1 201 Created
Location: https://api-sandbox.dwolla.com/documents/11fe0bab-39bd-42ee-bb39-275afcc050d0
Previous
2025 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.