[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76YAN89R8AFWH73V3T3PD8Z":3,"skill-same:01M76YAN89R8AFWH73V3T3PD8Z":56},{"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":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":40,"updatedAt":41,"install":42,"resources":55},"01M76YAN89R8AFWH73V3T3PD8Z","didit-email-verification",null,"Integrate Didit Email Verification standalone API to verify email addresses via OTP. Use when the user wants to verify emails, send email OTP codes, check email verification codes, detect breached or disposable emails, check if an email is undeliverable, or implement email-based identity verification using Didit. Supports fraud signals (IP, device, user agent), configurable code length, alphanumeric codes, and policy-based auto-decline for risky emails.","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-email-verification\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: didit-email-verification\ndescription: >\n  Integrate Didit Email Verification standalone API to verify email addresses via OTP.\n  Use when the user wants to verify emails, send email OTP codes, check email verification codes,\n  detect breached or disposable emails, check if an email is undeliverable, or implement\n  email-based identity verification using Didit. Supports fraud signals (IP, device, user agent),\n  configurable code length, alphanumeric codes, and policy-based auto-decline for risky emails.\nversion: 1.2.0\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - DIDIT_API_KEY\n    primaryEnv: DIDIT_API_KEY\n    emoji: \"✉️\"\n    homepage: https:\u002F\u002Fdocs.didit.me\n---\n\n# Didit Email Verification API\n\n## Overview\n\nTwo-step email verification via one-time code:\n\n1. **Send** a verification code to an email address\n2. **Check** the code the user provides\n\n**Key constraints:**\n- Code expires after **5 minutes**\n- Maximum **3 verification attempts** per code (then must resend)\n- Maximum **2 resend requests** within 24 hours\n- You **must call Send before Check** — Check returns `\"Expired or Not Found\"` otherwise\n\n**Capabilities:** Detects breached emails (via known data breaches), disposable\u002Ftemporary email providers, and undeliverable addresses. Supports fraud signals for risk scoring.\n\n**API Reference:** [Send Code](https:\u002F\u002Fdocs.didit.me\u002Fstandalone-apis\u002Femail-send) | [Check Code](https:\u002F\u002Fdocs.didit.me\u002Fstandalone-apis\u002Femail-check)\n**Feature Guide:** https:\u002F\u002Fdocs.didit.me\u002Fcore-technology\u002Femail-verification\u002Foverview\n\n---\n\n## Authentication\n\nAll requests require an API key via the `x-api-key` header.\n\n**How to obtain:** [Didit Business Console](https:\u002F\u002Fbusiness.didit.me) → API & Webhooks → Copy API key, or via programmatic registration (see below).\n\n```\nx-api-key: your_api_key_here\n```\n\n> `401` = API key missing or invalid. `403` = key lacks permissions or insufficient credits.\n\n## Getting Started (No Account Yet?)\n\nIf you don't have a Didit API key, create one in 2 API calls:\n\n1. **Register:** `POST https:\u002F\u002Fapx.didit.me\u002Fauth\u002Fv2\u002Fprogrammatic\u002Fregister\u002F` with `{\"email\": \"you@gmail.com\", \"password\": \"MyStr0ng!Pass\"}`\n2. **Check email** for a 6-character OTP code\n3. **Verify:** `POST https:\u002F\u002Fapx.didit.me\u002Fauth\u002Fv2\u002Fprogrammatic\u002Fverify-email\u002F` with `{\"email\": \"you@gmail.com\", \"code\": \"A3K9F2\"}` → response includes `api_key`\n\n**To add credits:** `GET \u002Fv3\u002Fbilling\u002Fbalance\u002F` to check, `POST \u002Fv3\u002Fbilling\u002Ftop-up\u002F` with `{\"amount_in_dollars\": 50}` for a Stripe checkout link.\n\nSee the **didit-verification-management** skill for full platform management (workflows, sessions, users, billing).\n\n---\n\n## Step 1: Send Email Code\n\nSends a one-time verification code to the specified email address.\n\n### Request\n\n```\nPOST https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fsend\u002F\n```\n\n### Headers\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 | Default | Constraints | Description |\n|---|---|---|---|---|---|\n| `email` | string | **Yes** | — | Valid email | Email address to send code to |\n| `options.code_size` | integer | No | `6` | Min: 4, Max: 8 | Length of the verification code |\n| `options.alphanumeric_code` | boolean | No | `false` | — | `true` = A-Z + 0-9 (case-insensitive) |\n| `options.locale` | string | No | — | Max 5 chars | Locale for email template. e.g. `en-US` |\n| `signals.ip` | string | No | — | IPv4 or IPv6 | User's IP for fraud detection |\n| `signals.device_id` | string | No | — | Max 255 chars | Unique device identifier |\n| `signals.user_agent` | string | No | — | Max 512 chars | Browser\u002Fclient user agent |\n| `vendor_data` | string | No | — | — | Your identifier for session tracking |\n\n### Example\n\n```python\nimport requests\n\nresponse = requests.post(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fsend\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\n        \"email\": \"user@example.com\",\n        \"options\": {\"code_size\": 6},\n        \"signals\": {\"ip\": \"203.0.113.42\"},\n        \"vendor_data\": \"session-abc-123\",\n    },\n)\nprint(response.status_code, response.json())\n```\n\n```typescript\nconst response = await fetch(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fsend\u002F\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\" },\n  body: JSON.stringify({\n    email: \"user@example.com\",\n    options: { code_size: 6 },\n    signals: { ip: \"203.0.113.42\" },\n  }),\n});\n```\n\n### Response (200 OK)\n\n```json\n{\n  \"request_id\": \"e39cb057-92fc-4b59-b84e-02fec29a0f24\",\n  \"status\": \"Success\",\n  \"reason\": null\n}\n```\n\n### Status Values & Handling\n\n| Status | Meaning | Action |\n|---|---|---|\n| `\"Success\"` | Code sent | Proceed — wait for user to provide code, then call Check |\n| `\"Retry\"` | Temporary delivery issue | Wait a few seconds and retry Send (max 2 retries) |\n| `\"Undeliverable\"` | Email cannot receive mail | Inform user the email is invalid or cannot receive messages |\n\n### Error Responses\n\n| Code | Meaning | Action |\n|---|---|---|\n| `400` | Invalid request body or email | Check email format and parameter constraints |\n| `401` | Invalid or missing API key | Verify `x-api-key` header |\n| `403` | Insufficient credits\u002Fpermissions | Check credits in Business Console |\n| `429` | Rate limited | Back off and retry after indicated period |\n\n---\n\n## Step 2: Check Email Code\n\nVerifies the code the user received. **Must be called after a successful Send.** Optionally auto-declines risky emails.\n\n### Request\n\n```\nPOST https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fcheck\u002F\n```\n\n### Headers\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 | Default | Values | Description |\n|---|---|---|---|---|---|\n| `email` | string | **Yes** | — | Valid email | Same email used in Step 1 |\n| `code` | string | **Yes** | — | 4-8 chars | The code the user received |\n| `duplicated_email_action` | string | No | `\"NO_ACTION\"` | `\"NO_ACTION\"` \u002F `\"DECLINE\"` | Decline if email already verified by another user |\n| `breached_email_action` | string | No | `\"NO_ACTION\"` | `\"NO_ACTION\"` \u002F `\"DECLINE\"` | Decline if email found in data breaches |\n| `disposable_email_action` | string | No | `\"NO_ACTION\"` | `\"NO_ACTION\"` \u002F `\"DECLINE\"` | Decline if email is disposable\u002Ftemporary |\n| `undeliverable_email_action` | string | No | `\"NO_ACTION\"` | `\"NO_ACTION\"` \u002F `\"DECLINE\"` | Decline if email is undeliverable |\n\n> **Policy note:** When an action is `\"DECLINE\"`, verification is rejected even if the code is correct. The `email.*` fields are still populated so you can inspect why.\n\n### Example\n\n```python\nresponse = requests.post(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fcheck\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\n        \"email\": \"user@example.com\",\n        \"code\": \"123456\",\n        \"breached_email_action\": \"DECLINE\",\n        \"disposable_email_action\": \"DECLINE\",\n    },\n)\n```\n\n```typescript\nconst response = await fetch(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fcheck\u002F\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\" },\n  body: JSON.stringify({\n    email: \"user@example.com\",\n    code: \"123456\",\n    breached_email_action: \"DECLINE\",\n    disposable_email_action: \"DECLINE\",\n  }),\n});\n```\n\n### Response (200 OK)\n\n```json\n{\n  \"request_id\": \"e39cb057-92fc-4b59-b84e-02fec29a0f24\",\n  \"status\": \"Approved\",\n  \"message\": \"The verification code is correct.\",\n  \"email\": {\n    \"status\": \"Approved\",\n    \"email\": \"user@example.com\",\n    \"is_breached\": false,\n    \"breaches\": [],\n    \"is_disposable\": false,\n    \"is_undeliverable\": false,\n    \"verification_attempts\": 1,\n    \"verified_at\": \"2025-09-15T17:36:19.963451Z\",\n    \"warnings\": [],\n    \"lifecycle\": [\n      {\"type\": \"EMAIL_VERIFICATION_MESSAGE_SENT\", \"timestamp\": \"...\", \"fee\": 0.03},\n      {\"type\": \"VALID_CODE_ENTERED\", \"timestamp\": \"...\", \"fee\": 0}\n    ]\n  },\n  \"created_at\": \"2025-09-15T17:36:19.703719+00:00\"\n}\n```\n\n### Status Values & Handling\n\n| Status | Meaning | Action |\n|---|---|---|\n| `\"Approved\"` | Code correct, no policy violations | Email verified — proceed with your flow |\n| `\"Failed\"` | Code incorrect | Ask user to re-enter. After 3 failures, resend a new code |\n| `\"Declined\"` | Code correct but policy violation | Inform user. Check `email.warnings` for reason |\n| `\"Expired or Not Found\"` | No pending code | Code expired (>5 min) or Send was never called. Resend |\n\n### Error Responses\n\n| Code | Meaning | Action |\n|---|---|---|\n| `400` | Invalid request body | Check email and code format |\n| `401` | Invalid or missing API key | Verify `x-api-key` header |\n| `403` | Insufficient credits\u002Fpermissions | Check credits in Business Console |\n| `404` | Code expired or not found | Resend a new code via Step 1 |\n\n---\n\n## Response Field Reference\n\n### `email` Object\n\n| Field | Type | Description |\n|---|---|---|\n| `status` | string | `\"Approved\"`, `\"Failed\"`, `\"Declined\"` |\n| `email` | string | The email address verified |\n| `is_breached` | boolean | Found in known data breaches |\n| `breaches` | array | Breach details: `{name, domain, breach_date, data_classes, breach_emails_count}` |\n| `is_disposable` | boolean | From a disposable\u002Ftemporary provider |\n| `is_undeliverable` | boolean | Cannot receive email |\n| `verification_attempts` | integer | Number of check attempts (max 3) |\n| `verified_at` | string | ISO 8601 timestamp when verified (`null` if not) |\n| `warnings` | array | Risk warnings: `{risk, log_type, short_description, long_description}` |\n| `lifecycle` | array | Event log: `{type, timestamp, fee}` |\n\n---\n\n## Warning Tags\n\n| Tag | Description | Auto-Decline |\n|---|---|---|\n| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | Max code entry attempts exceeded | Yes |\n| `EMAIL_IN_BLOCKLIST` | Email is in blocklist | Yes |\n| `UNDELIVERABLE_EMAIL_DETECTED` | Email cannot be delivered | Yes |\n| `BREACHED_EMAIL_DETECTED` | Found in known data breaches | Configurable |\n| `DISPOSABLE_EMAIL_DETECTED` | Disposable\u002Ftemporary provider | Configurable |\n| `DUPLICATED_EMAIL` | Already verified by another user | Configurable |\n\nWarning severity levels: `error` (critical), `warning` (requires attention), `information` (informational).\n\n---\n\n## Common Workflows\n\n### Basic Email Verification\n\n```\n1. POST \u002Fv3\u002Femail\u002Fsend\u002F   → {\"email\": \"user@example.com\"}\n2. Wait for user to provide the code\n3. POST \u002Fv3\u002Femail\u002Fcheck\u002F  → {\"email\": \"user@example.com\", \"code\": \"123456\"}\n4. If \"Approved\"            → email is verified\n   If \"Failed\"              → ask user to retry (up to 3 attempts)\n   If \"Expired or Not Found\"→ go back to step 1\n```\n\n### Strict Security Verification\n\n```\n1. POST \u002Fv3\u002Femail\u002Fsend\u002F   → include signals.ip, signals.device_id, signals.user_agent\n2. Wait for user to provide the code\n3. POST \u002Fv3\u002Femail\u002Fcheck\u002F  → set all *_action fields to \"DECLINE\"\n4. If \"Approved\"  → safe to proceed\n   If \"Declined\" → check email.warnings for reason, block or warn user\n```\n\n---\n\n## Utility Scripts\n\n**verify_email.py**: Send and check email verification codes from the command line.\n\n```bash\n# Requires: pip install requests\nexport DIDIT_API_KEY=\"your_api_key\"\n\npython scripts\u002Fverify_email.py send user@example.com\npython scripts\u002Fverify_email.py check user@example.com 123456 --decline-breached --decline-disposable\n```\n\nCan also be imported as a library:\n\n```python\nfrom scripts.verify_email import send_code, check_code\n\nsend_result = send_code(\"user@example.com\")\ncheck_result = check_code(\"user@example.com\", \"123456\", decline_breached=True)\n```\n","# Didit Email Verification API\n\n## Overview\n\nTwo-step email verification via one-time code:\n\n1. **Send** a verification code to an email address\n2. **Check** the code the user provides\n\n**Key constraints:**\n- Code expires after **5 minutes**\n- Maximum **3 verification attempts** per code (then must resend)\n- Maximum **2 resend requests** within 24 hours\n- You **must call Send before Check** — Check returns `\"Expired or Not Found\"` otherwise\n\n**Capabilities:** Detects breached emails (via known data breaches), disposable\u002Ftemporary email providers, and undeliverable addresses. Supports fraud signals for risk scoring.\n\n**API Reference:** [Send Code](https:\u002F\u002Fdocs.didit.me\u002Fstandalone-apis\u002Femail-send) | [Check Code](https:\u002F\u002Fdocs.didit.me\u002Fstandalone-apis\u002Femail-check)\n**Feature Guide:** https:\u002F\u002Fdocs.didit.me\u002Fcore-technology\u002Femail-verification\u002Foverview\n\n---\n\n## Authentication\n\nAll requests require an API key via the `x-api-key` header.\n\n**How to obtain:** [Didit Business Console](https:\u002F\u002Fbusiness.didit.me) → API & Webhooks → Copy API key, or via programmatic registration (see below).\n\n```\nx-api-key: your_api_key_here\n```\n\n> `401` = API key missing or invalid. `403` = key lacks permissions or insufficient credits.\n\n## Getting Started (No Account Yet?)\n\nIf you don't have a Didit API key, create one in 2 API calls:\n\n1. **Register:** `POST https:\u002F\u002Fapx.didit.me\u002Fauth\u002Fv2\u002Fprogrammatic\u002Fregister\u002F` with `{\"email\": \"you@gmail.com\", \"password\": \"MyStr0ng!Pass\"}`\n2. **Check email** for a 6-character OTP code\n3. **Verify:** `POST https:\u002F\u002Fapx.didit.me\u002Fauth\u002Fv2\u002Fprogrammatic\u002Fverify-email\u002F` with `{\"email\": \"you@gmail.com\", \"code\": \"A3K9F2\"}` → response includes `api_key`\n\n**To add credits:** `GET \u002Fv3\u002Fbilling\u002Fbalance\u002F` to check, `POST \u002Fv3\u002Fbilling\u002Ftop-up\u002F` with `{\"amount_in_dollars\": 50}` for a Stripe checkout link.\n\nSee the **didit-verification-management** skill for full platform management (workflows, sessions, users, billing).\n\n---\n\n## Step 1: Send Email Code\n\nSends a one-time verification code to the specified email address.\n\n### Request\n\n```\nPOST https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fsend\u002F\n```\n\n### Headers\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 | Default | Constraints | Description |\n|---|---|---|---|---|---|\n| `email` | string | **Yes** | — | Valid email | Email address to send code to |\n| `options.code_size` | integer | No | `6` | Min: 4, Max: 8 | Length of the verification code |\n| `options.alphanumeric_code` | boolean | No | `false` | — | `true` = A-Z + 0-9 (case-insensitive) |\n| `options.locale` | string | No | — | Max 5 chars | Locale for email template. e.g. `en-US` |\n| `signals.ip` | string | No | — | IPv4 or IPv6 | User's IP for fraud detection |\n| `signals.device_id` | string | No | — | Max 255 chars | Unique device identifier |\n| `signals.user_agent` | string | No | — | Max 512 chars | Browser\u002Fclient user agent |\n| `vendor_data` | string | No | — | — | Your identifier for session tracking |\n\n### Example\n\n```python\nimport requests\n\nresponse = requests.post(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fsend\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\n        \"email\": \"user@example.com\",\n        \"options\": {\"code_size\": 6},\n        \"signals\": {\"ip\": \"203.0.113.42\"},\n        \"vendor_data\": \"session-abc-123\",\n    },\n)\nprint(response.status_code, response.json())\n```\n\n```typescript\nconst response = await fetch(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fsend\u002F\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\" },\n  body: JSON.stringify({\n    email: \"user@example.com\",\n    options: { code_size: 6 },\n    signals: { ip: \"203.0.113.42\" },\n  }),\n});\n```\n\n### Response (200 OK)\n\n```json\n{\n  \"request_id\": \"e39cb057-92fc-4b59-b84e-02fec29a0f24\",\n  \"status\": \"Success\",\n  \"reason\": null\n}\n```\n\n### Status Values & Handling\n\n| Status | Meaning | Action |\n|---|---|---|\n| `\"Success\"` | Code sent | Proceed — wait for user to provide code, then call Check |\n| `\"Retry\"` | Temporary delivery issue | Wait a few seconds and retry Send (max 2 retries) |\n| `\"Undeliverable\"` | Email cannot receive mail | Inform user the email is invalid or cannot receive messages |\n\n### Error Responses\n\n| Code | Meaning | Action |\n|---|---|---|\n| `400` | Invalid request body or email | Check email format and parameter constraints |\n| `401` | Invalid or missing API key | Verify `x-api-key` header |\n| `403` | Insufficient credits\u002Fpermissions | Check credits in Business Console |\n| `429` | Rate limited | Back off and retry after indicated period |\n\n---\n\n## Step 2: Check Email Code\n\nVerifies the code the user received. **Must be called after a successful Send.** Optionally auto-declines risky emails.\n\n### Request\n\n```\nPOST https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fcheck\u002F\n```\n\n### Headers\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 | Default | Values | Description |\n|---|---|---|---|---|---|\n| `email` | string | **Yes** | — | Valid email | Same email used in Step 1 |\n| `code` | string | **Yes** | — | 4-8 chars | The code the user received |\n| `duplicated_email_action` | string | No | `\"NO_ACTION\"` | `\"NO_ACTION\"` \u002F `\"DECLINE\"` | Decline if email already verified by another user |\n| `breached_email_action` | string | No | `\"NO_ACTION\"` | `\"NO_ACTION\"` \u002F `\"DECLINE\"` | Decline if email found in data breaches |\n| `disposable_email_action` | string | No | `\"NO_ACTION\"` | `\"NO_ACTION\"` \u002F `\"DECLINE\"` | Decline if email is disposable\u002Ftemporary |\n| `undeliverable_email_action` | string | No | `\"NO_ACTION\"` | `\"NO_ACTION\"` \u002F `\"DECLINE\"` | Decline if email is undeliverable |\n\n> **Policy note:** When an action is `\"DECLINE\"`, verification is rejected even if the code is correct. The `email.*` fields are still populated so you can inspect why.\n\n### Example\n\n```python\nresponse = requests.post(\n    \"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fcheck\u002F\",\n    headers={\"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\"},\n    json={\n        \"email\": \"user@example.com\",\n        \"code\": \"123456\",\n        \"breached_email_action\": \"DECLINE\",\n        \"disposable_email_action\": \"DECLINE\",\n    },\n)\n```\n\n```typescript\nconst response = await fetch(\"https:\u002F\u002Fverification.didit.me\u002Fv3\u002Femail\u002Fcheck\u002F\", {\n  method: \"POST\",\n  headers: { \"x-api-key\": \"YOUR_API_KEY\", \"Content-Type\": \"application\u002Fjson\" },\n  body: JSON.stringify({\n    email: \"user@example.com\",\n    code: \"123456\",\n    breached_email_action: \"DECLINE\",\n    disposable_email_action: \"DECLINE\",\n  }),\n});\n```\n\n### Response (200 OK)\n\n```json\n{\n  \"request_id\": \"e39cb057-92fc-4b59-b84e-02fec29a0f24\",\n  \"status\": \"Approved\",\n  \"message\": \"The verification code is correct.\",\n  \"email\": {\n    \"status\": \"Approved\",\n    \"email\": \"user@example.com\",\n    \"is_breached\": false,\n    \"breaches\": [],\n    \"is_disposable\": false,\n    \"is_undeliverable\": false,\n    \"verification_attempts\": 1,\n    \"verified_at\": \"2025-09-15T17:36:19.963451Z\",\n    \"warnings\": [],\n    \"lifecycle\": [\n      {\"type\": \"EMAIL_VERIFICATION_MESSAGE_SENT\", \"timestamp\": \"...\", \"fee\": 0.03},\n      {\"type\": \"VALID_CODE_ENTERED\", \"timestamp\": \"...\", \"fee\": 0}\n    ]\n  },\n  \"created_at\": \"2025-09-15T17:36:19.703719+00:00\"\n}\n```\n\n### Status Values & Handling\n\n| Status | Meaning | Action |\n|---|---|---|\n| `\"Approved\"` | Code correct, no policy violations | Email verified — proceed with your flow |\n| `\"Failed\"` | Code incorrect | Ask user to re-enter. After 3 failures, resend a new code |\n| `\"Declined\"` | Code correct but policy violation | Inform user. Check `email.warnings` for reason |\n| `\"Expired or Not Found\"` | No pending code | Code expired (>5 min) or Send was never called. Resend |\n\n### Error Responses\n\n| Code | Meaning | Action |\n|---|---|---|\n| `400` | Invalid request body | Check email and code format |\n| `401` | Invalid or missing API key | Verify `x-api-key` header |\n| `403` | Insufficient credits\u002Fpermissions | Check credits in Business Console |\n| `404` | Code expired or not found | Resend a new code via Step 1 |\n\n---\n\n## Response Field Reference\n\n### `email` Object\n\n| Field | Type | Description |\n|---|---|---|\n| `status` | string | `\"Approved\"`, `\"Failed\"`, `\"Declined\"` |\n| `email` | string | The email address verified |\n| `is_breached` | boolean | Found in known data breaches |\n| `breaches` | array | Breach details: `{name, domain, breach_date, data_classes, breach_emails_count}` |\n| `is_disposable` | boolean | From a disposable\u002Ftemporary provider |\n| `is_undeliverable` | boolean | Cannot receive email |\n| `verification_attempts` | integer | Number of check attempts (max 3) |\n| `verified_at` | string | ISO 8601 timestamp when verified (`null` if not) |\n| `warnings` | array | Risk warnings: `{risk, log_type, short_description, long_description}` |\n| `lifecycle` | array | Event log: `{type, timestamp, fee}` |\n\n---\n\n## Warning Tags\n\n| Tag | Description | Auto-Decline |\n|---|---|---|\n| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | Max code entry attempts exceeded | Yes |\n| `EMAIL_IN_BLOCKLIST` | Email is in blocklist | Yes |\n| `UNDELIVERABLE_EMAIL_DETECTED` | Email cannot be delivered | Yes |\n| `BREACHED_EMAIL_DETECTED` | Found in known data breaches | Configurable |\n| `DISPOSABLE_EMAIL_DETECTED` | Disposable\u002Ftemporary provider | Configurable |\n| `DUPLICATED_EMAIL` | Already verified by another user | Configurable |\n\nWarning severity levels: `error` (critical), `warning` (requires attention), `information` (informational).\n\n---\n\n## Common Workflows\n\n### Basic Email Verification\n\n```\n1. POST \u002Fv3\u002Femail\u002Fsend\u002F   → {\"email\": \"user@example.com\"}\n2. Wait for user to provide the code\n3. POST \u002Fv3\u002Femail\u002Fcheck\u002F  → {\"email\": \"user@example.com\", \"code\": \"123456\"}\n4. If \"Approved\"            → email is verified\n   If \"Failed\"              → ask user to retry (up to 3 attempts)\n   If \"Expired or Not Found\"→ go back to step 1\n```\n\n### Strict Security Verification\n\n```\n1. POST \u002Fv3\u002Femail\u002Fsend\u002F   → include signals.ip, signals.device_id, signals.user_agent\n2. Wait for user to provide the code\n3. POST \u002Fv3\u002Femail\u002Fcheck\u002F  → set all *_action fields to \"DECLINE\"\n4. If \"Approved\"  → safe to proceed\n   If \"Declined\" → check email.warnings for reason, block or warn user\n```\n\n---\n\n## Utility Scripts\n\n**verify_email.py**: Send and check email verification codes from the command line.\n\n```bash\n# Requires: pip install requests\nexport DIDIT_API_KEY=\"your_api_key\"\n\npython scripts\u002Fverify_email.py send user@example.com\npython scripts\u002Fverify_email.py check user@example.com 123456 --decline-breached --decline-disposable\n```\n\nCan also be imported as a library:\n\n```python\nfrom scripts.verify_email import send_code, check_code\n\nsend_result = send_code(\"user@example.com\")\ncheck_result = check_code(\"user@example.com\", \"123456\", decline_breached=True)\n```\n",{"name":5,"version":24,"metadata":25,"description":32},"1.2.0",{"openclaw":26},{"emoji":27,"homepage":28,"requires":29,"primaryEnv":31},"✉️","https:\u002F\u002Fdocs.didit.me",{"env":30},[31],"DIDIT_API_KEY","Integrate Didit Email Verification standalone API to verify email addresses via OTP. Use when the user wants to verify emails, send email OTP codes, check email verification codes, detect breached or disposable emails, check if an email is undeliverable, or implement email-based identity verification using Didit. Supports fraud signals (IP, device, user agent), configurable code length, alphanumeric codes, and policy-based auto-decline for risky emails.\n","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Frosasalberto\u002Fdidit-email-verification",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":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill didit-email-verification",{"tool":48,"command":49},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill didit-email-verification",{"tool":51,"command":52},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill didit-email-verification","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Frosasalberto\u002Fdidit-email-verification\u002FSKILL.md",true,[],[57,65,72,79,86,93],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":64},"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":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":64},"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":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":64},"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":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":64},"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":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":64},"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":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":64},"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",[],[]]