didit-sessions
Integrate Didit Session & Workflow APIs — the central hub for managing verification sessions. Use when the user wants to create a verification session, set up a KYC workflow, create a session with a workflow_id, retrieve session results, get session decisions, list sessions, delete sessions, update session status, approve or decline sessions, request resubmission, generate PDF reports, share sessions between partners, import shared sessions, add or remove users from blocklist, manage blocked faces/documents/phones/emails, handle webhooks, or implement any end-to-end verification flow using Didit. Covers 11 API endpoints: create, retrieve, list, delete, update-status, generate-pdf, share, import-shared, blocklist-add, blocklist-remove, blocklist-list.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/rosasalberto/didit-sessionsDidit Session & Workflow APIs
Overview
Sessions are the core unit of Didit verification. Every verification starts by creating a session linked to a workflow (configured in Console). The workflow defines what checks run (ID, liveness, AML, etc.) and the decision logic.
Base URL: https://verification.didit.me/v3
Session lifecycle:
Create Session → User verifies at URL → Receive webhook/poll decision → Optionally update status
Rate limits: 300 req/min per method. Session creation: 600 req/min. Decision polling: 100 req/min. On 429: check Retry-After header, use exponential backoff.
API Reference: https://docs.didit.me/reference/create-session-verification-sessions
Authentication
All requests require x-api-key header. Get your key from Didit Business Console → API & Webhooks.
Session Statuses
| Status | Description | Terminal |
|---|---|---|
Not Started | Created, user hasn't begun | No |
In Progress | User is completing verification | No |
In Review | Needs manual review | No |
Approved | Verification successful | Yes |
Declined | Verification failed | Yes |
Abandoned | User left without completing | Yes |
Expired | Session expired (default: 7 days) | Yes |
Resubmitted | Steps sent back for resubmission | No |
Workflow Types
Workflows are created in the Business Console (UI only, not via API). Each has a unique workflow_id.
| Template | Starts With | Use Case |
|---|---|---|
| KYC | ID Verification (OCR) | Full identity onboarding |
| Adaptive Age Verification | Selfie age estimation | Age-gated services (auto-fallback to ID if borderline) |
| Biometric Authentication | Liveness detection | Re-verify returning users (pass portrait_image) |
| Address Verification | Proof of Address | Residential address validation |
| Questionnaire | Custom questionnaire | Structured attestations and documents |
Two build modes:
- Simple Mode: Toggle features on/off from a template
- Advanced Mode: Visual node-based graph builder with conditional branches, parallel paths, action automation
Available features in workflows: ID Verification, Liveness, Face Match, NFC, AML Screening, Phone Verification, Email Verification, Proof of Address, Database Validation, IP Analysis, Age Estimation, Questionnaire.
1. Create Session
POST /v3/session/
| Header | Value | Required |
|---|---|---|
x-api-key | Your API key | Yes |
Content-Type | application/json | Yes |
Body (JSON)
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-rosasalberto-didit-sessions": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
didit-proof-of-address
Integrate Didit Proof of Address standalone API to verify address documents. Use when the user wants to verify a proof of address, validate utility bills, bank statements, government documents, extract address from documents, verify residential address, implement address verification, or perform PoA checks using Didit. Supports OCR extraction, geocoding, name matching, and multi-page documents.
didit-aml-screening
Integrate Didit AML Screening standalone API to screen individuals or companies against global watchlists. Use when the user wants to perform AML checks, screen against sanctions lists, check PEP status, detect adverse media, implement KYC/AML compliance, screen against OFAC/UN/EU watchlists, calculate risk scores, or perform anti-money laundering screening using Didit. Supports 1300+ databases, fuzzy name matching, configurable scoring weights, and continuous monitoring.
didit-age-estimation
Integrate Didit Age Estimation standalone API to estimate a person's age from a facial image. Use when the user wants to estimate age, verify age, implement age gating, check if someone is over 18/21, perform age verification for compliance, or use facial analysis for age detection using Didit. Includes passive liveness check. Supports configurable thresholds, adaptive age estimation with ID verification fallback, and per-country age restrictions.
didit-passive-liveness
Integrate Didit Passive Liveness standalone API to verify a user is physically present. Use when the user wants to check liveness, detect spoofing attempts, verify real person presence, implement anti-spoofing, or perform passive liveness detection using Didit. Analyzes a single image without user interaction. Returns liveness score, face quality, and luminance metrics. Detects presentation attacks and duplicate faces.
didit-phone-verification
Integrate Didit Phone Verification standalone API to verify phone numbers via OTP. Use when the user wants to verify phones, send SMS or WhatsApp or Telegram codes, check phone verification codes, detect disposable or VoIP numbers, or implement phone-based identity verification using Didit. Supports multiple delivery channels (SMS, WhatsApp, Telegram, voice), fraud signals, and policy-based auto-decline.