Skip to main content
Get from zero to a live identity verification in minutes — create your account, set up a workflow, launch a session, and start receiving results.
1

Set up your deepidv account

  1. Head to app.deepidv.com and sign up
  2. Create your Organization — this is the workspace where your team manages workflows, API credentials, and verification activity
  3. Make sure your account has a sufficient token balance to run verifications
Each verification service consumes tokens at its own rate. Check the Pricing page for a full breakdown of per-check costs.
2

Create a verification workflow

Open Workflows in the sidebar and click Create New. A workflow defines which checks run during a session:
ServiceWhat it does
ID VerificationValidates government-issued documents and extracts key fields
Face LivenessConfirms the applicant is a real, live person
Age EstimationEstimates the applicant’s age from biometric data
PEP & SanctionsScreens against global watchlists and sanctions registries
Adverse MediaScreens for negative news coverage and media mentions
Bank Statement SyncRetrieves bank statements via open banking
AI Bank AnalysisRuns AI-powered analysis on financial data
Document Upload with Fraud DetectionCollects uploaded documents and scans them for signs of tampering or fraud
Custom Prompt PictureRequests a photo from the applicant based on a custom prompt you define
Custom FormsAdds custom questions or data collection fields to the verification flow
Title SearchSearches property title records for ownership and lien information
Address VerificationUses AI-driven prompts to verify the applicant’s location in real time
Phone VerificationCalls the applicant and verifies their identity through a spoken voice prompt
Toggle the services you need, name your workflow, and save it. You can create as many workflows as you like for different use cases.
3

Grab your API key

Go to Settings → API Keys in the Admin Console:
  1. Click Generate API Key and copy it somewhere safe
  2. Optionally, configure a Webhook URL to receive real-time status updates when sessions change
Your API key is a secret. Keep it server-side only — never expose it in frontend code or commit it to version control.
4

Launch a verification session

Option A — Verification sessions (recommended)The fastest way to get started. Create a session through the Admin Console or programmatically via the API. Your applicant receives an email and/or SMS with a link to complete their verification.In the Console, click ”+” → pick a workflow → enter applicant details. Or create sessions via code:
curl -X POST https://api.deepidv.com/v1/sessions \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane.smith@example.com",
    "phone": "+14165557890",
    "workflowId": "your-workflow-id"
  }'
Find your workflowId under Workflows in the Admin Console sidebar.
A successful response returns a session ID and verification URL:
{
  "idv_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "session_url": "https://app.deepidv.com",
  "links": []
}
Option B — Direct API calls (Coming soon!)Call individual verification endpoints directly from your backend — no session required. Ideal for server-to-server or fully custom integrations.See the full endpoint list in the API Reference.
5

Track results

Once an applicant completes their verification, deepidv automatically processes the results. Sessions move through these statuses:
StatusMeaning
PENDINGSession created, awaiting applicant
SUBMITTEDApplicant completed the flow, results are processing
VERIFIEDAll checks passed
REJECTEDOne or more checks failed
VOIDEDSession manually cancelled by a reviewer
If you configured a webhook, deepidv sends events to your endpoint automatically — no polling required.You can also retrieve session results at any time via the Retrieve Session endpoint.
6

Review and manage

Use the Admin Console to:
  • Monitor session progress in real time
  • Manually review and approve or reject flagged sessions
  • Export individual PDF reports or bulk CSV downloads
  • Filter sessions by status, date range, workflow, or applicant
  • View detailed analytics and token spend on the Analytics dashboard

​
Need help?

Email Support

Reach our team at support@deepidv.com

API Reference

Explore the full API documentation and endpoint specs.