Documents
Documents are the core evidence submitted for identity verification. Each verification can have one document per type: Photo ID, Proof of Address, and optionally a Selfie.
Document Types
| Type | Required | Purpose |
|---|---|---|
| Photo ID | Yes | Government-issued identification (passport, driver license, ID card, etc.) |
| Proof of Address | Yes (USPS 1583) | Utility bill, bank statement, or other address verification |
| Selfie | Optional | Live selfie for face matching with the photo ID |
The required document types depend on the flow configuration. The USPS 1583 flow typically requires both photo ID and proof of address.
Document Statuses
| Status | Value | Description |
|---|---|---|
| Uploaded | 1 | Document image has been uploaded to storage |
| In Progress | 2 | Document is being processed by extraction pipeline |
| Approved | 3 | All validation rules passed |
| Rejected | 4 | One or more validation rules failed |
| Double Check | 5 | Flagged for manual review |
| Canceled | 6 | Document was canceled |
| Extracted | 7 | data has been extracted from the document |
Uploading Documents
Documents can be uploaded via:
- API — Base64-encoded images sent directly
- Widget — End-user captures or uploads images through the embedded SPA
Document Sides
Documents may have one or two sides depending on the document type and issuing country:
- Front side — Always required
- Back side — Required unless the document type is single-sided for the selected country
For example, a US Passport is typically single-sided, while a US Driver License requires both front and back.
Image Requirements
- Maximum file size: 10 MB per side
- Supported formats: JPEG, PNG, PDF (base64-encoded)
- Images are stored securely in S3 and served via temporary signed URLs (30-minute expiry)
Duplicate Documents
Each verification can have at most one document per document type. Attempting to upload a second photo ID when one already exists will result in an error.
Document Processing Pipeline
Once a document is uploaded, it goes through the processing pipeline:
Document Actions
View Document
Documents can be viewed via temporary signed URLs that expire after 30 minutes. Both front and back side images are available when applicable.
Download Document
Documents can be downloaded. This is useful for record-keeping and audit purposes.
Update Extracted Data
After extraction, reviewers can manually correct the extracted data:
- Photo data — Update person details extracted from the photo ID
- Address data — Update address details extracted from the proof of address
This is useful when extraction pipeline results are incorrect and a manual correction is needed before making a decision.
Delete Document
Documents can be deleted if they were uploaded in error. Deleting a document allows uploading a replacement. Only documents in non-terminal states can be deleted.
Selfie Capture
If the flow configuration requires a selfie:
- The widget guides the user through live selfie capture
- A face comparison score is generated between the photo ID and the selfie
Common Issues
| Issue | Cause | Solution |
|---|---|---|
| Blurry images | Low camera quality or movement | Retake the photo with steady lighting |
| Wrong document type | User selected incorrect type | Delete and re-upload with correct type |
| Extraction failure | Poor image quality or unusual format | Upload a cleaner image or use a different document |
| Back side required | Document is two-sided for the country | Upload both sides |
| Document too large | Exceeds 10MB limit | Compress the image before uploading |