Introduction

Colleckt is a multi-tenant identity verification platform designed for virtual address and mailbox providers that need to comply with USPS Form 1583 requirements. The platform automates the end-to-end verification lifecycle — from identity document collection through extraction pipelines, automated validation, manual review, and final decision.

What It Does

Colleckt enables businesses to:

• Create identity verification requests with expected person, address, and document information
• Collect supporting documents via an embeddable end-user widget or directly through the API
• Extract and validate data using OCR technology and internal validation rules
• Make decisions — approve, reject, or flag for manual review
• Receive real-time notifications via webhooks when verification status changes
• Manage the full lifecycle — hold, resume, cancel, resubmit, and track verifications

Who It's For

Role	Use Case
Integrators	Connect the API to your existing systems
Operations teams	Review verifications, manage users, monitor activity
End users	Complete identity verification via the embedded widget

Key Concepts

Workspaces

Each customer gets an isolated workspace (tenant) with its own subdomain and database. Workspaces come in two environment types:

• Production — live customer data
• Sandbox — test and integration environment

Workspace URLs follow this pattern:

https://{workspace}.colleckt.io

Flows

A flow defines a verification process configuration, including:

• Required document types (photo ID, proof of address)
• Accepted document types per country
• Forbidden document type + country combinations
• Associated products and pricing

The following default flows are available:

Flow	Slug	Purpose
USPS 1583	usps1583	Identity verification for virtual address providers
USPS 1583 Skip Country	usps1583-skip-country	USPS 1583 verification for cases where the document country and number are unknown
Identity	identity	General identity verification without USPS-specific requirements

USPS 1583 Skip Country

The USPS 1583 Skip Country flow behaves identically to USPS 1583 — same document types, products, pricing, and supported countries — but is intended for cases where the applicant's document-issuing country and document number are not known upfront.

Instead of matching those values against what you expect, the flow accepts whatever the extraction pipeline reads from the uploaded documents. Compared to USPS 1583, the following validations are skipped:

• Photo ID issuing-country match
• Proof of address issuing-country match
• Photo ID document-number match

All other validation rules run exactly as they do for USPS 1583. Use this flow when you cannot reliably provide the expected issuing country or document number when creating the verification.

Document Types

Three categories of documents can be collected:

Type	Code	Purpose
Photo ID	PHOTO_ID	Government-issued identification (passport, driver license, ID card)
Proof of Address	PROOF_OF_ADDRESS	Utility bill, bank statement, or other address verification
Selfie	SELFIE	Live selfie capture for face-matching

Verification Statuses

Every verification moves through a lifecycle:

Loading diagram...

Status	Value	Description
Started	1	Verification created, awaiting document upload
Submitted	2	Documents uploaded, pipeline processing
Approved	3	All validations passed
Rejected	4	Validation failed
Double Check	5	Flagged for manual review
Expired	6	Verification timed out
Canceled	7	Verification canceled
Hold	8	Verification paused

Platform Interfaces

Colleckt provides three interfaces:

1. Dashboard — Web-based management interface for operations teams (user management, reviews, reports)
2. API — RESTful API for programmatic integration
3. Widget — Embeddable end-user verification flow (SPA v1, v2, v3)

Security & Compliance

The platform implements:

• Multi-factor authentication via email OTP
• Role-based access control
• API authentication via Bearer tokens
• Webhook signing
• Account lockout after repeated failed login attempts
• SOC 2 aligned controls

Getting Started

1. Request a workspace — Contact support to provision your workspace
2. Log in to the dashboard — Access your workspace at https://{workspace}.colleckt.io
3. Generate an API token — Navigate to Settings → API Tokens in the dashboard
4. Create your first verification — Use the API to create a verification and generate a widget URL
5. Configure webhooks — Set up event notifications for state changes
6. Monitor activity — Use the dashboard to track verifications, view reports, and manage reviews

Try the API

Test the API interactively in the Playground → with your workspace token.