[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76YBHT6PYK2CWZ9YMXFH77T":3,"skill-same:01M76YBHT6PYK2CWZ9YMXFH77T":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":41,"updatedAt":42,"install":43,"resources":56},"01M76YBHT6PYK2CWZ9YMXFH77T","didit-sessions",null,"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\u002Fdocuments\u002Fphones\u002Femails, 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.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Frosasalberto\u002Fdidit-sessions\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: didit-sessions\ndescription: >\n  Integrate Didit Session & Workflow APIs — the central hub for managing verification sessions.\n  Use when the user wants to create a verification session, set up a KYC workflow, create a\n  session with a workflow_id, retrieve session results, get session decisions, list sessions,\n  delete sessions, update session status, approve or decline sessions, request resubmission,\n  generate PDF reports, share sessions between partners, import shared sessions, add or remove\n  users from blocklist, manage blocked faces\u002Fdocuments\u002Fphones\u002Femails, handle webhooks, or\n  implement any end-to-end verification flow using Didit.\n  Covers 11 API endpoints: create, retrieve, list, delete, update-status, generate-pdf,\n  share, import-shared, blocklist-add, blocklist-remove, blocklist-list.\nversion: 2.0.0\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - DIDIT_API_KEY\n        - DIDIT_WORKFLOW_ID\n    primaryEnv: DIDIT_API_KEY\n    emoji: \"🔄\"\n    homepage: https:\u002F\u002Fdocs.didit.me\n---\n\n# Didit Session & Workflow APIs\n\n## Overview\n\nSessions 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.\n\n**Base URL:** `https:\u002F\u002Fverification.didit.me\u002Fv3`\n\n**Session lifecycle:**\n```\nCreate Session → User verifies at URL → Receive webhook\u002Fpoll decision → Optionally update status\n```\n\n**Rate limits:** 300 req\u002Fmin per method. Session creation: 600 req\u002Fmin. Decision polling: 100 req\u002Fmin. On 429: check `Retry-After` header, use exponential backoff.\n\n**API Reference:** https:\u002F\u002Fdocs.didit.me\u002Freference\u002Fcreate-session-verification-sessions\n\n---\n\n## Authentication\n\nAll requests require `x-api-key` header. Get your key from [Didit Business Console](https:\u002F\u002Fbusiness.didit.me) → API & Webhooks.\n\n---\n\n## Session Statuses\n\n| Status | Description | Terminal |\n|---|---|---|\n| `Not Started` | Created, user hasn't begun | No |\n| `In Progress` | User is completing verification | No |\n| `In Review` | Needs manual review | No |\n| `Approved` | Verification successful | Yes |\n| `Declined` | Verification failed | Yes |\n| `Abandoned` | User left without completing | Yes |\n| `Expired` | Session expired (default: 7 days) | Yes |\n| `Resubmitted` | Steps sent back for resubmission | No |\n\n---\n\n## Workflow Types\n\nWorkflows are created in the **Business Console** (UI only, not via API). Each has a unique `workflow_id`.\n\n| Template | Starts With | Use Case |\n|---|---|---|\n| **KYC** | ID Verification (OCR) | Full identity onboarding |\n| **Adaptive Age Verification** | Selfie age estimation | Age-gated services (auto-fallback to ID if borderline) |\n| **Biometric Authentication** | Liveness detection | Re-verify returning users (pass `portrait_image`) |\n| **Address Verification** | Proof of Address | Residential address validation |\n| **Questionnaire** | Custom questionnaire | Structured attestations and documents |\n\n**Two build modes:**\n- **Simple Mode**: Toggle features on\u002Foff from a template\n- **Advanced Mode**: Visual node-based graph builder with conditional branches, parallel paths, action automation\n\n**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.\n\n---\n\n## 1. Create Session\n\n```\nPOST \u002Fv3\u002Fsession\u002F\n```\n\n| Header | Value | Required |\n|---|---|---|\n| `x-api-key` | Your API key | **Yes** |\n| `Content-Type` | `application\u002Fjson` | **Yes** |\n\n### Body (JSON)\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `workflow_id` | uuid | **Yes** | Workflow ID from Console → Workflows |\n| `vendor_data` | string | No | Your identifier (UUID\u002Femail) for tracking |\n| `callback` | url | No | Redirect URL. Didit appends `verificationSessionId` + `status` as query params |\n| `callback_method` | string | No | `\"initiator\"` (default), `\"completer\"`, or `\"both\"` — which device handles redirect |\n| `metadata` | JSON string | No | Custom data stored with session. e.g. `{\"account_id\": \"ABC123\"}` |\n| `language` | string | No | ISO 639-1 code for UI language (auto-detected if omitted) |\n| `contact_details.email` | string | No | Pre-fill email for email verification step |\n| `contact_details.phone` | string | No | Pre-fill phone (E.164) for phone verification step |\n| `contact_details.send_notification_emails` | boolean | No | Send status update emails (default: `false`) |\n| `expected_details.first_name` | string | No | Expected first name (triggers mismatch warning if different) |\n| `expected_details.last_name` | string | No | Expected last name |\n| `expected_details.date_of_birth` | string | No | Expected DOB (`YYYY-MM-DD`) |\n| `expected_details.gender` | string | No | `\"M\"`, `\"F\"`, or `null` |\n| `expected_details.nationality` | string | No | ISO 3166-1 alpha-3 (e.g. `USA`) |\n| `portrait_image` | base64 | No | Reference portrait for Biometric Auth workflows (max 1MB) |\n\n### Example\n\n```python\nimport requests\n\nresponse = requests.post(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\n        \"workflow_id\": \"d8d2fa2d-c69c-471c-b7bc-bc71512b43ef\",\n        \"vendor_data\": \"user-123\",\n        \"callback\": \"https:\u002F\u002Fyourapp.com\u002Fcallback\",\n        \"language\": \"en\",\n    },\n)\nsession = response.json()\n# session[\"url\"] → send user here to verify\n# session[\"session_token\"] → use for SDK initialization\n```\n\n```typescript\nconst response = await fetch(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\" },\n  body: JSON.stringify({\n    workflow_id: \"d8d2fa2d-c69c-471c-b7bc-bc71512b43ef\",\n    vendor_data: \"user-123\",\n    callback: \"https:\u002F\u002Fyourapp.com\u002Fcallback\",\n  }),\n});\nconst session = await response.json();\n\u002F\u002F session.url → redirect user here\n```\n\n### Response (201 Created)\n\n```json\n{\n  \"session_id\": \"11111111-2222-3333-4444-555555555555\",\n  \"session_number\": 1234,\n  \"session_token\": \"abcdef123456\",\n  \"url\": \"https:\u002F\u002Fverify.didit.me\u002Fsession\u002Fabcdef123456\",\n  \"vendor_data\": \"user-123\",\n  \"status\": \"Not Started\",\n  \"workflow_id\": \"d8d2fa2d-c69c-471c-b7bc-bc71512b43ef\",\n  \"callback\": \"https:\u002F\u002Fyourapp.com\u002Fcallback\"\n}\n```\n\n| Error | Meaning | Action |\n|---|---|---|\n| `400` | Invalid workflow_id or insufficient credits | Verify workflow ID exists, check credits |\n| `403` | No permission | Check API key permissions |\n\n---\n\n## 2. Retrieve Session (Get Decision)\n\n```\nGET \u002Fv3\u002Fsession\u002F{sessionId}\u002Fdecision\u002F\n```\n\nReturns all verification results for a completed session. Image\u002Fmedia URLs expire after **60 minutes**.\n\n### Response (200 OK)\n\n```json\n{\n  \"session_id\": \"...\",\n  \"status\": \"Approved\",\n  \"features\": [\"ID_VERIFICATION\", \"LIVENESS\", \"FACE_MATCH\", \"AML\"],\n  \"vendor_data\": \"user-123\",\n  \"id_verifications\": [{\"status\": \"Approved\", \"document_type\": \"...\", \"first_name\": \"...\"}],\n  \"liveness_checks\": [{\"status\": \"Approved\", \"method\": \"ACTIVE_3D\", \"score\": 89.92}],\n  \"face_matches\": [{\"status\": \"Approved\", \"score\": 95.5}],\n  \"phone_verifications\": [{\"status\": \"Approved\", \"full_number\": \"+14155552671\"}],\n  \"email_verifications\": [{\"status\": \"Approved\", \"email\": \"user@example.com\"}],\n  \"aml_screenings\": [{\"status\": \"Approved\", \"total_hits\": 0}],\n  \"poa_verifications\": [...],\n  \"nfc_verifications\": [...],\n  \"ip_analyses\": [...],\n  \"database_validations\": [...],\n  \"reviews\": [...]\n}\n```\n\n---\n\n## 3. List Sessions\n\n```\nGET \u002Fv3\u002Fsessions\u002F\n```\n\n| Query Param | Type | Description |\n|---|---|---|\n| `vendor_data` | string | Filter by your identifier |\n| `status` | string | Filter by status |\n| `page` | integer | Page number |\n| `page_size` | integer | Results per page |\n\n### Response (200 OK)\n\n```json\n{\n  \"count\": 42,\n  \"next\": \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsessions\u002F?page=2\",\n  \"previous\": null,\n  \"results\": [\n    {\"session_id\": \"...\", \"session_number\": 34, \"status\": \"Approved\", \"vendor_data\": \"user-123\", \"created_at\": \"...\"}\n  ]\n}\n```\n\n```python\nresponse = requests.get(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsessions\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\"},\n    params={\"vendor_data\": \"user-123\", \"status\": \"Approved\"},\n)\n```\n\n---\n\n## 4. Delete Session\n\n```\nDELETE \u002Fv3\u002Fsession\u002F{sessionId}\u002Fdelete\u002F\n```\n\nPermanently deletes a session and **all associated data**. Returns `204 No Content` on success, `404` if not found.\n\n```python\nresponse = requests.delete(\n    f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fdelete\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\"},\n)\n# response.status_code == 204 → success\n```\n\n---\n\n## 5. Update Session Status\n\n```\nPATCH \u002Fv3\u002Fsession\u002F{sessionId}\u002Fupdate-status\u002F\n```\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `new_status` | string | **Yes** | `\"Approved\"`, `\"Declined\"`, or `\"Resubmitted\"` |\n| `comment` | string | No | Reason for status change |\n| `send_email` | boolean | No | Send email notification (default: `false`) |\n| `email_address` | string | No* | **Required** when `send_email` is `true` |\n| `email_language` | string | No | Language for email (default: `\"en\"`) |\n| `nodes_to_resubmit` | array | No | For Resubmitted: `[{\"node_id\": \"feature_ocr\", \"feature\": \"OCR\"}]` |\n\n> **Resubmit:** Session must be Declined, In Review, or Abandoned. Approved steps are preserved.\n\n```python\n# Approve\nrequests.patch(f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fupdate-status\u002F\",\n    headers=headers, json={\"new_status\": \"Approved\", \"comment\": \"Manual review passed\"})\n\n# Resubmit specific steps with notification\nrequests.patch(f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fupdate-status\u002F\",\n    headers=headers, json={\n        \"new_status\": \"Resubmitted\",\n        \"nodes_to_resubmit\": [{\"node_id\": \"feature_ocr\", \"feature\": \"OCR\"}],\n        \"send_email\": True, \"email_address\": \"user@example.com\"\n    })\n```\n\n---\n\n## 6. Generate PDF Report\n\n```\nGET \u002Fv3\u002Fsession\u002F{sessionId}\u002Fgenerate-pdf\n```\n\nGenerates a PDF verification report. Rate limited to **100 req\u002Fmin** (CPU-bound).\n\n```python\nresponse = requests.get(\n    f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fgenerate-pdf\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\"},\n)\n# Returns PDF content or URL\n```\n\n---\n\n## 7. Share Session\n\nGenerate a `share_token` for B2B KYC sharing. Only works for **finished sessions** (Approved, Declined, In Review).\n\n```\nPOST \u002Fv3\u002Fsession\u002F{sessionId}\u002Fshare\u002F\n```\n\n```python\nresponse = requests.post(\n    f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fshare\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n)\nshare_token = response.json()[\"share_token\"]\n# Transmit share_token to partner via your backend\n```\n\n---\n\n## 8. Import Shared Session\n\nUsed by the **receiving partner** to import a shared verification session.\n\n```\nPOST \u002Fv3\u002Fsession\u002Fimport-shared\u002F\n```\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `share_token` | string | **Yes** | Token from the sharing partner |\n| `trust_review` | boolean | **Yes** | `true`: keep original status. `false`: set to \"In Review\" |\n| `workflow_id` | string | **Yes** | Your workflow ID to associate |\n| `vendor_data` | string | No | Your own user identifier |\n\n```python\nresponse = requests.post(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002Fimport-shared\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\n        \"share_token\": \"eyJhbGciOiJIUzI1NiIs...\",\n        \"trust_review\": True,\n        \"workflow_id\": \"your-workflow-uuid\",\n        \"vendor_data\": \"user-789\",\n    },\n)\n```\n\n> A session can only be imported **once** per partner application. Requires legal data sharing agreement + user consent.\n\n---\n\n## 9. Blocklist — Add\n\nBlock faces, documents, phones, emails from a session. Matching items auto-decline future sessions.\n\n```\nPOST \u002Fv3\u002Fblocklist\u002Fadd\u002F\n```\n\n| Parameter | Type | Required | Default | Description |\n|---|---|---|---|---|\n| `session_id` | uuid | **Yes** | — | Session to blocklist items from |\n| `blocklist_face` | boolean | No | `false` | Block biometric face template |\n| `blocklist_document` | boolean | No | `false` | Block document fingerprint |\n| `blocklist_phone` | boolean | No | `false` | Block phone number |\n| `blocklist_email` | boolean | No | `false` | Block email address |\n\n```python\nrequests.post(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fblocklist\u002Fadd\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\"session_id\": \"...\", \"blocklist_face\": True, \"blocklist_document\": True})\n```\n\n**Auto-decline warnings when matched:**\n\n| Entity | Warning Tag |\n|---|---|\n| Face | `FACE_IN_BLOCKLIST` |\n| Document | `ID_DOCUMENT_IN_BLOCKLIST` |\n| Phone | `PHONE_NUMBER_IN_BLOCKLIST` |\n| Email | `EMAIL_IN_BLOCKLIST` |\n\n---\n\n## 10. Blocklist — Remove\n\n```\nPOST \u002Fv3\u002Fblocklist\u002Fremove\u002F\n```\n\n| Parameter | Type | Required | Default | Description |\n|---|---|---|---|---|\n| `session_id` | uuid | **Yes** | — | Session to unblock items from |\n| `unblock_face` | boolean | No | `false` | Unblock face |\n| `unblock_document` | boolean | No | `false` | Unblock document |\n| `unblock_phone` | boolean | No | `false` | Unblock phone |\n| `unblock_email` | boolean | No | `false` | Unblock email |\n\n```python\nrequests.post(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fblocklist\u002Fremove\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\"session_id\": \"...\", \"unblock_face\": True})\n```\n\n---\n\n## 11. Blocklist — List\n\n```\nGET \u002Fv3\u002Fblocklist\u002F\n```\n\n| Query Param | Type | Description |\n|---|---|---|\n| `item_type` | string | Filter: `\"face\"`, `\"document\"`, `\"phone\"`, `\"email\"`. Omit for all |\n\n---\n\n## Error Responses (All Endpoints)\n\n| Code | Meaning | Action |\n|---|---|---|\n| `400` | Invalid request body or parameters | Check required fields and formats |\n| `401` | Invalid or missing API key | Verify `x-api-key` header |\n| `403` | Insufficient credits or no permission | Check credits in Business Console |\n| `404` | Session not found | Verify session_id |\n| `429` | Rate limited | Check `Retry-After` header, exponential backoff |\n\n---\n\n## Common Workflows\n\n### Basic KYC Flow\n\n```\n1. POST \u002Fv3\u002Fsession\u002F → create session with KYC workflow_id, get URL\n2. Redirect user to session URL\n3. Listen for webhook OR poll GET \u002Fv3\u002Fsession\u002F{id}\u002Fdecision\u002F\n4. \"Approved\"  → user verified\n   \"Declined\"  → check decision, optionally resubmit\n   \"In Review\" → manual review or auto-decide via API\n```\n\n### Programmatic Review + Blocklist\n\n```\n1. Receive webhook: status \"In Review\"\n2. GET \u002Fv3\u002Fsession\u002F{id}\u002Fdecision\u002F → inspect all results\n3. Apply business logic\n4. If fraud: PATCH → Declined + POST \u002Fv3\u002Fblocklist\u002Fadd\u002F (block all entities)\n   If legit: PATCH → Approved\n```\n\n### B2B KYC Sharing\n\n```\nService X:\n1. POST \u002Fv3\u002Fsession\u002F{id}\u002Fshare\u002F → get share_token\n2. Transmit token to Service Y via backend\n\nService Y:\n3. POST \u002Fv3\u002Fsession\u002Fimport-shared\u002F → import with trust_review=true\n4. Session imported instantly with original status\n```\n\n### Biometric Re-Authentication\n\n```\n1. Retrieve portrait_image from user's initial approved session\n2. POST \u002Fv3\u002Fsession\u002F → biometric auth workflow + portrait_image\n3. User takes selfie → system matches against portrait\n4. \"Approved\" → identity re-confirmed\n```\n","# Didit Session & Workflow APIs\n\n## Overview\n\nSessions 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.\n\n**Base URL:** `https:\u002F\u002Fverification.didit.me\u002Fv3`\n\n**Session lifecycle:**\n```\nCreate Session → User verifies at URL → Receive webhook\u002Fpoll decision → Optionally update status\n```\n\n**Rate limits:** 300 req\u002Fmin per method. Session creation: 600 req\u002Fmin. Decision polling: 100 req\u002Fmin. On 429: check `Retry-After` header, use exponential backoff.\n\n**API Reference:** https:\u002F\u002Fdocs.didit.me\u002Freference\u002Fcreate-session-verification-sessions\n\n---\n\n## Authentication\n\nAll requests require `x-api-key` header. Get your key from [Didit Business Console](https:\u002F\u002Fbusiness.didit.me) → API & Webhooks.\n\n---\n\n## Session Statuses\n\n| Status | Description | Terminal |\n|---|---|---|\n| `Not Started` | Created, user hasn't begun | No |\n| `In Progress` | User is completing verification | No |\n| `In Review` | Needs manual review | No |\n| `Approved` | Verification successful | Yes |\n| `Declined` | Verification failed | Yes |\n| `Abandoned` | User left without completing | Yes |\n| `Expired` | Session expired (default: 7 days) | Yes |\n| `Resubmitted` | Steps sent back for resubmission | No |\n\n---\n\n## Workflow Types\n\nWorkflows are created in the **Business Console** (UI only, not via API). Each has a unique `workflow_id`.\n\n| Template | Starts With | Use Case |\n|---|---|---|\n| **KYC** | ID Verification (OCR) | Full identity onboarding |\n| **Adaptive Age Verification** | Selfie age estimation | Age-gated services (auto-fallback to ID if borderline) |\n| **Biometric Authentication** | Liveness detection | Re-verify returning users (pass `portrait_image`) |\n| **Address Verification** | Proof of Address | Residential address validation |\n| **Questionnaire** | Custom questionnaire | Structured attestations and documents |\n\n**Two build modes:**\n- **Simple Mode**: Toggle features on\u002Foff from a template\n- **Advanced Mode**: Visual node-based graph builder with conditional branches, parallel paths, action automation\n\n**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.\n\n---\n\n## 1. Create Session\n\n```\nPOST \u002Fv3\u002Fsession\u002F\n```\n\n| Header | Value | Required |\n|---|---|---|\n| `x-api-key` | Your API key | **Yes** |\n| `Content-Type` | `application\u002Fjson` | **Yes** |\n\n### Body (JSON)\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `workflow_id` | uuid | **Yes** | Workflow ID from Console → Workflows |\n| `vendor_data` | string | No | Your identifier (UUID\u002Femail) for tracking |\n| `callback` | url | No | Redirect URL. Didit appends `verificationSessionId` + `status` as query params |\n| `callback_method` | string | No | `\"initiator\"` (default), `\"completer\"`, or `\"both\"` — which device handles redirect |\n| `metadata` | JSON string | No | Custom data stored with session. e.g. `{\"account_id\": \"ABC123\"}` |\n| `language` | string | No | ISO 639-1 code for UI language (auto-detected if omitted) |\n| `contact_details.email` | string | No | Pre-fill email for email verification step |\n| `contact_details.phone` | string | No | Pre-fill phone (E.164) for phone verification step |\n| `contact_details.send_notification_emails` | boolean | No | Send status update emails (default: `false`) |\n| `expected_details.first_name` | string | No | Expected first name (triggers mismatch warning if different) |\n| `expected_details.last_name` | string | No | Expected last name |\n| `expected_details.date_of_birth` | string | No | Expected DOB (`YYYY-MM-DD`) |\n| `expected_details.gender` | string | No | `\"M\"`, `\"F\"`, or `null` |\n| `expected_details.nationality` | string | No | ISO 3166-1 alpha-3 (e.g. `USA`) |\n| `portrait_image` | base64 | No | Reference portrait for Biometric Auth workflows (max 1MB) |\n\n### Example\n\n```python\nimport requests\n\nresponse = requests.post(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\n        \"workflow_id\": \"d8d2fa2d-c69c-471c-b7bc-bc71512b43ef\",\n        \"vendor_data\": \"user-123\",\n        \"callback\": \"https:\u002F\u002Fyourapp.com\u002Fcallback\",\n        \"language\": \"en\",\n    },\n)\nsession = response.json()\n# session[\"url\"] → send user here to verify\n# session[\"session_token\"] → use for SDK initialization\n```\n\n```typescript\nconst response = await fetch(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\" },\n  body: JSON.stringify({\n    workflow_id: \"d8d2fa2d-c69c-471c-b7bc-bc71512b43ef\",\n    vendor_data: \"user-123\",\n    callback: \"https:\u002F\u002Fyourapp.com\u002Fcallback\",\n  }),\n});\nconst session = await response.json();\n\u002F\u002F session.url → redirect user here\n```\n\n### Response (201 Created)\n\n```json\n{\n  \"session_id\": \"11111111-2222-3333-4444-555555555555\",\n  \"session_number\": 1234,\n  \"session_token\": \"abcdef123456\",\n  \"url\": \"https:\u002F\u002Fverify.didit.me\u002Fsession\u002Fabcdef123456\",\n  \"vendor_data\": \"user-123\",\n  \"status\": \"Not Started\",\n  \"workflow_id\": \"d8d2fa2d-c69c-471c-b7bc-bc71512b43ef\",\n  \"callback\": \"https:\u002F\u002Fyourapp.com\u002Fcallback\"\n}\n```\n\n| Error | Meaning | Action |\n|---|---|---|\n| `400` | Invalid workflow_id or insufficient credits | Verify workflow ID exists, check credits |\n| `403` | No permission | Check API key permissions |\n\n---\n\n## 2. Retrieve Session (Get Decision)\n\n```\nGET \u002Fv3\u002Fsession\u002F{sessionId}\u002Fdecision\u002F\n```\n\nReturns all verification results for a completed session. Image\u002Fmedia URLs expire after **60 minutes**.\n\n### Response (200 OK)\n\n```json\n{\n  \"session_id\": \"...\",\n  \"status\": \"Approved\",\n  \"features\": [\"ID_VERIFICATION\", \"LIVENESS\", \"FACE_MATCH\", \"AML\"],\n  \"vendor_data\": \"user-123\",\n  \"id_verifications\": [{\"status\": \"Approved\", \"document_type\": \"...\", \"first_name\": \"...\"}],\n  \"liveness_checks\": [{\"status\": \"Approved\", \"method\": \"ACTIVE_3D\", \"score\": 89.92}],\n  \"face_matches\": [{\"status\": \"Approved\", \"score\": 95.5}],\n  \"phone_verifications\": [{\"status\": \"Approved\", \"full_number\": \"+14155552671\"}],\n  \"email_verifications\": [{\"status\": \"Approved\", \"email\": \"user@example.com\"}],\n  \"aml_screenings\": [{\"status\": \"Approved\", \"total_hits\": 0}],\n  \"poa_verifications\": [...],\n  \"nfc_verifications\": [...],\n  \"ip_analyses\": [...],\n  \"database_validations\": [...],\n  \"reviews\": [...]\n}\n```\n\n---\n\n## 3. List Sessions\n\n```\nGET \u002Fv3\u002Fsessions\u002F\n```\n\n| Query Param | Type | Description |\n|---|---|---|\n| `vendor_data` | string | Filter by your identifier |\n| `status` | string | Filter by status |\n| `page` | integer | Page number |\n| `page_size` | integer | Results per page |\n\n### Response (200 OK)\n\n```json\n{\n  \"count\": 42,\n  \"next\": \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsessions\u002F?page=2\",\n  \"previous\": null,\n  \"results\": [\n    {\"session_id\": \"...\", \"session_number\": 34, \"status\": \"Approved\", \"vendor_data\": \"user-123\", \"created_at\": \"...\"}\n  ]\n}\n```\n\n```python\nresponse = requests.get(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsessions\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\"},\n    params={\"vendor_data\": \"user-123\", \"status\": \"Approved\"},\n)\n```\n\n---\n\n## 4. Delete Session\n\n```\nDELETE \u002Fv3\u002Fsession\u002F{sessionId}\u002Fdelete\u002F\n```\n\nPermanently deletes a session and **all associated data**. Returns `204 No Content` on success, `404` if not found.\n\n```python\nresponse = requests.delete(\n    f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fdelete\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\"},\n)\n# response.status_code == 204 → success\n```\n\n---\n\n## 5. Update Session Status\n\n```\nPATCH \u002Fv3\u002Fsession\u002F{sessionId}\u002Fupdate-status\u002F\n```\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `new_status` | string | **Yes** | `\"Approved\"`, `\"Declined\"`, or `\"Resubmitted\"` |\n| `comment` | string | No | Reason for status change |\n| `send_email` | boolean | No | Send email notification (default: `false`) |\n| `email_address` | string | No* | **Required** when `send_email` is `true` |\n| `email_language` | string | No | Language for email (default: `\"en\"`) |\n| `nodes_to_resubmit` | array | No | For Resubmitted: `[{\"node_id\": \"feature_ocr\", \"feature\": \"OCR\"}]` |\n\n> **Resubmit:** Session must be Declined, In Review, or Abandoned. Approved steps are preserved.\n\n```python\n# Approve\nrequests.patch(f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fupdate-status\u002F\",\n    headers=headers, json={\"new_status\": \"Approved\", \"comment\": \"Manual review passed\"})\n\n# Resubmit specific steps with notification\nrequests.patch(f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fupdate-status\u002F\",\n    headers=headers, json={\n        \"new_status\": \"Resubmitted\",\n        \"nodes_to_resubmit\": [{\"node_id\": \"feature_ocr\", \"feature\": \"OCR\"}],\n        \"send_email\": True, \"email_address\": \"user@example.com\"\n    })\n```\n\n---\n\n## 6. Generate PDF Report\n\n```\nGET \u002Fv3\u002Fsession\u002F{sessionId}\u002Fgenerate-pdf\n```\n\nGenerates a PDF verification report. Rate limited to **100 req\u002Fmin** (CPU-bound).\n\n```python\nresponse = requests.get(\n    f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fgenerate-pdf\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\"},\n)\n# Returns PDF content or URL\n```\n\n---\n\n## 7. Share Session\n\nGenerate a `share_token` for B2B KYC sharing. Only works for **finished sessions** (Approved, Declined, In Review).\n\n```\nPOST \u002Fv3\u002Fsession\u002F{sessionId}\u002Fshare\u002F\n```\n\n```python\nresponse = requests.post(\n    f\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002F{session_id}\u002Fshare\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n)\nshare_token = response.json()[\"share_token\"]\n# Transmit share_token to partner via your backend\n```\n\n---\n\n## 8. Import Shared Session\n\nUsed by the **receiving partner** to import a shared verification session.\n\n```\nPOST \u002Fv3\u002Fsession\u002Fimport-shared\u002F\n```\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `share_token` | string | **Yes** | Token from the sharing partner |\n| `trust_review` | boolean | **Yes** | `true`: keep original status. `false`: set to \"In Review\" |\n| `workflow_id` | string | **Yes** | Your workflow ID to associate |\n| `vendor_data` | string | No | Your own user identifier |\n\n```python\nresponse = requests.post(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fsession\u002Fimport-shared\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\n        \"share_token\": \"eyJhbGciOiJIUzI1NiIs...\",\n        \"trust_review\": True,\n        \"workflow_id\": \"your-workflow-uuid\",\n        \"vendor_data\": \"user-789\",\n    },\n)\n```\n\n> A session can only be imported **once** per partner application. Requires legal data sharing agreement + user consent.\n\n---\n\n## 9. Blocklist — Add\n\nBlock faces, documents, phones, emails from a session. Matching items auto-decline future sessions.\n\n```\nPOST \u002Fv3\u002Fblocklist\u002Fadd\u002F\n```\n\n| Parameter | Type | Required | Default | Description |\n|---|---|---|---|---|\n| `session_id` | uuid | **Yes** | — | Session to blocklist items from |\n| `blocklist_face` | boolean | No | `false` | Block biometric face template |\n| `blocklist_document` | boolean | No | `false` | Block document fingerprint |\n| `blocklist_phone` | boolean | No | `false` | Block phone number |\n| `blocklist_email` | boolean | No | `false` | Block email address |\n\n```python\nrequests.post(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fblocklist\u002Fadd\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\"session_id\": \"...\", \"blocklist_face\": True, \"blocklist_document\": True})\n```\n\n**Auto-decline warnings when matched:**\n\n| Entity | Warning Tag |\n|---|---|\n| Face | `FACE_IN_BLOCKLIST` |\n| Document | `ID_DOCUMENT_IN_BLOCKLIST` |\n| Phone | `PHONE_NUMBER_IN_BLOCKLIST` |\n| Email | `EMAIL_IN_BLOCKLIST` |\n\n---\n\n## 10. Blocklist — Remove\n\n```\nPOST \u002Fv3\u002Fblocklist\u002Fremove\u002F\n```\n\n| Parameter | Type | Required | Default | Description |\n|---|---|---|---|---|\n| `session_id` | uuid | **Yes** | — | Session to unblock items from |\n| `unblock_face` | boolean | No | `false` | Unblock face |\n| `unblock_document` | boolean | No | `false` | Unblock document |\n| `unblock_phone` | boolean | No | `false` | Unblock phone |\n| `unblock_email` | boolean | No | `false` | Unblock email |\n\n```python\nrequests.post(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Fblocklist\u002Fremove\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\"session_id\": \"...\", \"unblock_face\": True})\n```\n\n---\n\n## 11. Blocklist — List\n\n```\nGET \u002Fv3\u002Fblocklist\u002F\n```\n\n| Query Param | Type | Description |\n|---|---|---|\n| `item_type` | string | Filter: `\"face\"`, `\"document\"`, `\"phone\"`, `\"email\"`. Omit for all |\n\n---\n\n## Error Responses (All Endpoints)\n\n| Code | Meaning | Action |\n|---|---|---|\n| `400` | Invalid request body or parameters | Check required fields and formats |\n| `401` | Invalid or missing API key | Verify `x-api-key` header |\n| `403` | Insufficient credits or no permission | Check credits in Business Console |\n| `404` | Session not found | Verify session_id |\n| `429` | Rate limited | Check `Retry-After` header, exponential backoff |\n\n---\n\n## Common Workflows\n\n### Basic KYC Flow\n\n```\n1. POST \u002Fv3\u002Fsession\u002F → create session with KYC workflow_id, get URL\n2. Redirect user to session URL\n3. Listen for webhook OR poll GET \u002Fv3\u002Fsession\u002F{id}\u002Fdecision\u002F\n4. \"Approved\"  → user verified\n   \"Declined\"  → check decision, optionally resubmit\n   \"In Review\" → manual review or auto-decide via API\n```\n\n### Programmatic Review + Blocklist\n\n```\n1. Receive webhook: status \"In Review\"\n2. GET \u002Fv3\u002Fsession\u002F{id}\u002Fdecision\u002F → inspect all results\n3. Apply business logic\n4. If fraud: PATCH → Declined + POST \u002Fv3\u002Fblocklist\u002Fadd\u002F (block all entities)\n   If legit: PATCH → Approved\n```\n\n### B2B KYC Sharing\n\n```\nService X:\n1. POST \u002Fv3\u002Fsession\u002F{id}\u002Fshare\u002F → get share_token\n2. Transmit token to Service Y via backend\n\nService Y:\n3. POST \u002Fv3\u002Fsession\u002Fimport-shared\u002F → import with trust_review=true\n4. Session imported instantly with original status\n```\n\n### Biometric Re-Authentication\n\n```\n1. Retrieve portrait_image from user's initial approved session\n2. POST \u002Fv3\u002Fsession\u002F → biometric auth workflow + portrait_image\n3. User takes selfie → system matches against portrait\n4. \"Approved\" → identity re-confirmed\n```\n",{"name":5,"version":24,"metadata":25,"description":33},"2.0.0",{"openclaw":26},{"emoji":27,"homepage":28,"requires":29,"primaryEnv":31},"🔄","https:\u002F\u002Fdocs.didit.me",{"env":30},[31,32],"DIDIT_API_KEY","DIDIT_WORKFLOW_ID","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\u002Fdocuments\u002Fphones\u002Femails, 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.\n","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Frosasalberto\u002Fdidit-sessions",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill didit-sessions",{"tool":49,"command":50},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill didit-sessions",{"tool":52,"command":53},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill didit-sessions","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Frosasalberto\u002Fdidit-sessions\u002FSKILL.md",true,[],[58,66,73,80,87,94],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":65},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":65},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":65},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":65},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":65},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":65},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]