Create a document for a customer #

Create a document for a Customer 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.

Acceptable documents #

Customer typeAcceptable documentsPersonal Verified Customerpassport, license, or idCard. Must be a color scan of U.S. government-issued identification. Foreign passports will be rejected with ForeignPassportNotAllowed if uploaded for this customer type.Business Verified CustomerController documents - passport, license, or idCard.
  • If license or idCard, must be a color scan of U.S. government-issued identification.
  • If passport, U.S. as well as foreign passports are accepted for business Controllers and Beneficial Owners.
Business documents - 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 FieldDescriptiondocumentTypeAcceptable 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.fileFile contents.

HTTP status and error codes #

HTTP StatusCodeDescription201CreatedA document resource was created.400maximumNumberOfResourcesMax of four files upload allowed. Please wait for Dwolla to manually check the documents.400invalidFileTypeFile types supported:
Personal IDs - .jpg, .jpeg or .png.
Business Documents - .jpg, .jpeg, .png, or .pdf.400DuplicateResourceDocument already exists. Follow the link to find the existing document for the Customer.403invalidResourceStateResource cannot be modified. Document creation not allowed for already verified Customers or non-verified Customer types.403notAuthorizedNot authorized to create documents.404notFoundCustomer not found. Check CustomerId.413fileTooLargeDocument requests are limited to 10 MiB.

Request and response #

JavaScript
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
// Using form-data - https://github.com/form-data/form-data (Not Maintained By Dwolla)
var customerUrl =
  "https://api-sandbox.dwolla.com/customers/1de32eC7-ff0b-4c0c-9f09-19629e6788ce";

var requestBody = new FormData();
requestBody.append("file", fs.createReadStream("mclovin.jpg"), {
  filename: "mclovin.jpg",
  contentType: "image/jpeg",
  knownLength: fs.statSync("mclovin.jpg").size,
});
requestBody.append("documentType", "license");

dwolla
  .post(`${customerUrl}/documents`, requestBody)
  .then((res) => res.headers.get("location")); // => "https://api-sandbox.dwolla.com/documents/fb919e0b-ffbe-4268-b1e2-947b44328a16"

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys
2022 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.