> ## Documentation Index
> Fetch the complete documentation index at: https://developers.dwolla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Create, list, and retrieve documents from Customers and Beneficial Owners.

# Documents

Verified Customers of type `personal` or `business` and of status `document` require color photos of identifying documents to be uploaded for manual review in order to be verified. Currently, SDK support for document upload only exists for Ruby, Node.js, and Python. To upload a document using other languages, you must use an external HTTP library.

For more information on handling the Customer verification status of `document`, reference our [Business Customer](/docs/business-verified-customer#handling-document-status) or [Personal Customer](/docs/personal-verified-customer#handling-status-document) guides.

### Document resource

| Parameter                  | Description                                                                                                                                                                                                                                                                                                                      |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                         | Document unique identifier                                                                                                                                                                                                                                                                                                       |
| type                       | Either `passport`, `license`, `idCard`, or `other`. Must be a colored camera captured image of a U.S. government issued identification.                                                                                                                                                                                          |
| status                     | Either `pending` or `reviewed`. When a document has been manually reviewed by Dwolla, its status will be `reviewed`. A reviewed document does not necessarily indicate that the customer has completed the identity verification process.                                                                                        |
| documentVerificationStatus | The value of this field indicates the status of the document after being reviewed by Dwolla. Values can be either `pending`, `accepted`, or `rejected`.                                                                                                                                                                          |
| created                    | ISO 8601 Timestamp of document upload time and date.                                                                                                                                                                                                                                                                             |
| failureReason              | The reason an uploaded document was rejected. Can be: `BusinessDocNotSupported`, `BusinessNameMismatch`, `BusinessTypeMismatch`, `ForeignPassportNotAllowed`, `ScanDobMismatch`, `ScanFailedOther`, `ScanIdExpired`, `ScanIdTypeNotSupported`, `ScanIdUnrecognized`, `ScanNameMismatch`, `ScanNotReadable` or `ScanNotUploaded`. |
| allFailureReasons          | An array of `reason`s and `description`s for when an uploaded document is rejected for multiple reasons.                                                                                                                                                                                                                         |

```bash theme={"dark"}
{
  "_links": {
    "self": {
      "href": "https://api.dwolla.com/documents/56502f7a-fa59-4a2f-8579-0f8bc9d7b9cc"
    }
  },
  "id": "56502f7a-fa59-4a2f-8579-0f8bc9d7b9cc",
  "status": "reviewed",
  "type": "passport",
  "created": "2015-09-29T21:42:16.000Z",
  "documentVerificationStatus": "rejected",
  "failureReason": "ScanDobMismatch",
  "allFailureReasons": [
      {
          "reason": "ScanDobMismatch",
          "description": "Scan DOB does not match DOB on account"
      },
      {
          "reason": "ScanIdExpired",
          "description": "ID is expired or missing expiration date"
      }
  ]
}
```
