Developer API

Integrate vHu's privacy-first human verification into your applications, bots, and services with our simple RESTful API.

Getting Started

1. Get Your API Key

Sign up for a vHu account and generate your API key from the dashboard. API keys start with vhu_

# Your API key (keep this secret!)
API_KEY="vhu_live_abc123xyz789..."

2. Generate a Verification Link

Make a POST request to create a verification link that you can share via DM, Telegram, or any messaging platform.

curl -X POST https://api.vhu.io/generate-link \
  -H "Content-Type: application/json" \
  -H "x-api-key: vhu_live_abc123xyz789..." \
  -d '{
    "notificationEmail": "your@email.com",
    "webhookUrl": "https://your-app.com/webhook",
    "metadata": {
      "userId": "user123",
      "context": "telegram-bot"
    }
  }'

3. Check Verification Status

Poll the status endpoint or receive webhook notifications when users complete verification.

curl -X GET "https://api.vhu.io/check-status?linkId=abc123xyz" \
  -H "x-api-key: vhu_live_abc123xyz789..."

Official SDKs Coming Soon

We're working on official SDKs for JavaScript, Python, Go, and PHP to make integration even easier.