Getting Started with VerifyHuman

Last Updated: November 30, 2025

Welcome to VerifyHuman! This guide will help you integrate AI-powered verification into your application in minutes.

What is VerifyHuman?

VerifyHuman is a comprehensive verification platform that offers four products to protect your application:

Quick Start (5 minutes)

1. Create Your Account

1. Sign up at app.verifyhuman.io
2. Verify your email address
3. You'll get 50 free verification credits to start

2. Choose Your Product

Select the verification product that matches your use case:

VerifyHuman - Bot Detection

Block bots and verify real humans with a quick selfie check.

Best for: Signup forms, comments, reviews, giveaways

curl -X POST https://app.verifyhuman.io/api/verify \
  -F "clientKey=vhk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6" \
  -F "file=@selfie.jpg"

VerifyAge - Age Verification

Verify user age with AI age estimation and optional ID verification.

Best for: Age-restricted content, alcohol sales, adult services

curl -X POST https://app.verifyhuman.io/api/v1/verify-age/verify \
  -H "X-API-Key: vhk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6" \
  -H "Content-Type: application/json" \
  -d '{
    "image_selfie_b64": "base64_image",
    "use_case": "alcohol",
    "min_age": 21
  }'

VerifyIdentity - KYC Verification

Verify identity with selfie + government ID matching.

Best for: Financial apps, marketplaces, account verification

curl -X POST https://app.verifyhuman.io/api/identity/v1/submit \
  -H "X-API-Key: vhk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6" \
  -H "Content-Type: application/json" \
  -d '{
    "selfie_b64": "base64_selfie",
    "id_front_b64": "base64_id"
  }'

VerifyCompliance - KYC+ with AML/Sanctions

Advanced KYC with integrated AML/PEP/Sanctions screening.

Best for: Crypto exchanges, financial institutions, regulated businesses

Requires: Pro or Enterprise plan

curl -X POST https://app.verifyhuman.io/api/kyc/v1/submit_plus \
  -H "X-API-Key: vhk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6" \
  -H "Content-Type: application/json" \
  -d '{
    "selfie_b64": "base64_selfie",
    "id_front_b64": "base64_id"
  }'

3. Get Your API Key

1. Go to your Dashboard
2. Navigate to API Keys
3. Click "Create New API Key"
4. Name your key and select which product scopes to enable
5. Click Generate and save your key securely

Unified API Key Format:

All API keys use the same format with product scopes:

When creating a key, select which products it can access: VerifyHuman, VerifyAge, VerifyIdentity, or VerifyCompliance (Pro/Enterprise only).

4. Test the Integration

Choose your integration method:

Option A: REST API (Recommended)

Direct API integration with full control.

VerifyHuman Example:

const formData = new FormData();
formData.append('clientKey', 'vhk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6');
formData.append('file', imageFile);

const response = await fetch('https://app.verifyhuman.io/api/verify', {
    method: 'POST',
    body: formData
});

const result = await response.json();
console.log(result.status); // "PASS" or "FAIL"

VerifyAge Example:

const response = await fetch('https://app.verifyhuman.io/api/v1/verify-age/verify', {
    method: 'POST',
    headers: {
        'X-API-Key': 'vhk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        image_selfie_b64: base64Image,
        use_case: 'alcohol',
        min_age: 21
    })
});

const result = await response.json();
console.log(result.verified); // true or false

Option B: Embeddable Widget

Add verification to any webpage with our JavaScript widget.

<script src="https://app.verifyhuman.io/widget.js"></script>
<div id="verifyhuman-widget" 
     data-product="verifyhuman"
     data-api-key="vhk-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
     data-on-success="handleSuccess"
     data-on-failure="handleFailure">
</div>

<script>
function handleSuccess(result) {
    console.log('Verified!', result);
}

function handleFailure(error) {
    console.error('Failed:', error);
}
</script>

Option C: Hosted Flow (No-Code)

Generate a secure hosted verification page - no coding required.

1. Go to Dashboard → Hosted Flows
2. Select your product
3. Configure settings and branding
4. Copy the generated link
5. Share with users or embed on your site

Perfect for: Quick implementation, non-technical teams

Integration Paths

For Developers

• Complete API Documentation
• Authentication Guide
• Code Examples (Python, Node.js, PHP)
• Widget Integration Guide

For No-Code Platforms

• WordPress Plugin
• Hosted Flows Guide

Product-Specific Guides

• VerifyHuman Guide - Bot detection & liveness
• VerifyAge Guide - Age verification
• VerifyIdentity Guide - KYC verification
• VerifyCompliance Guide - AML/sanctions screening

Understanding API Responses

VerifyHuman Response

{
  "verification_id": "ver_abc123",
  "status": "PASS",
  "confidence": 95.7,
  "is_real_face": true,
  "token": "eyJ0eXAiOiJKV1QiLCJhbGci..."
}

VerifyAge Response

{
  "verified": true,
  "method": "selfie",
  "estimated_age": 28,
  "age_range": { "Low": 25, "High": 31 },
  "confidence": 92.5,
  "credits_consumed": 10
}

VerifyIdentity Response

{
  "success": true,
  "verified": true,
  "face_match": { "similarity": 95.8, "is_match": true },
  "document_data": {
    "name": "JOHN DOE",
    "date_of_birth": "05/15/1990",
    "document_type": "Driver License"
  },
  "credits_consumed": 30
}

VerifyCompliance Response

{
  "success": true,
  "verified": true,
  "compliance_screening": {
    "performed": true,
    "status": "Cleared",
    "total_hits": 0
  },
  "credits_consumed": 50
}

Your Privacy is Protected

We never store verification media or biometric data. All images are:

• Processed in-memory only
• Immediately discarded after verification
• Never saved to disk, cache, or logs
• Not accessible after verification completes

GDPR & CCPA Compliant - Learn more in our Privacy Policy.

Pricing Overview

Product Credits

Subscription Plans

• Free: 50 credits (VerifyHuman, VerifyAge, VerifyIdentity)
• Starter: 1,000 credits/month
• Growth: 10,000 credits/month
• Pro: 100,000 credits/month (includes VerifyCompliance)
• Enterprise: Custom pricing, unlimited credits

View Detailed Pricing

Need Help?

• Live Chat: Available in your dashboard
• Email Support: support@verifyhuman.io
• Documentation: docs.verifyhuman.io
• Status Page: status.verifyhuman.io
• API Reference: docs.verifyhuman.io/api

Next Steps

1. Choose your product based on your use case
2. Generate API key for your selected product
3. Test the API with our examples
4. Integrate into your app using REST API or widgets
5. Go live and start verifying users

Ready to protect your app? Let's get started!