Create a document for a client
POST https://api-sandbox.dwolla.com/clients/{{clientAccountId}}/documents
Create a document for a Client Account pending verification by uploading a color scan or photo of government issued identification (see below for acceptable document types). This requires a multipart form-data POST request. The uploaded file must be a color image, in a .jpg, .jpeg, or .png format, and less than 10MB in size. Additionally, Business Documents can also be uploaded in a .pdf format.
Request parameters
| Form field | Description |
|---|---|
| file | File contents. |
| documentType | Acceptable values of: passport, license, idCard, or other. |
HTTP status and error codes
| HTTP Status | Code | Message | Description |
|---|---|---|---|
| 201 | Created | Success | A document resource was created. |
| 400 | BadFile | There was an error with the provided file. | Check file and try again. |
| 400 | InvalidFileType | Invalid file type. | File types supported: Personal IDs - .jpg, .jpeg or .png. Business Documents - .jpg, .jpeg, .png, or .pdf. |
| 400 | MaxNumberOfResources | Only 4 documents can be uploaded when verifying a customer. | Max of four files upload allowed. Please wait for Dwolla to manually check the documents |
| 400 | DuplicateResource | Document already exists. | Document already exists. Follow the link to find the existing document for the Client. |
| 403 | InvalidResourceState | Resource cannot be modified. | Document creation not allowed for already verified Client. |
| 404 | NotFound | The requested resource was not found. | Client Account not found. Check Client Account Id. |
| 413 | FileTooLarge | The provided document is too large. 10MB is the maximum file size allowed. | Document requests are limited to 10 MiB. |
Request Body
[{"name"=>"file", "value"=>nil, "datatype"=>"null"}, {"name"=>"documentType", "value"=>"passport", "datatype"=>"string"}]
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string | ||
Content-Type | string | ||
Cache-Control | string | ||
Authorization | string |
RESPONSES
status: Created
""