Getting Started with YeboVerify

YeboVerify is a B2B identity verification API that helps businesses verify the identity of their users through facial recognition and document verification.

Overview

YeboVerify offers two verification modes:

1. Selfie Match - Compare a selfie against a profile picture URL
2. ID Document Verification - Full identity verification with face matching and OCR extraction

Quick Start

1. Get Your API Key

Contact us at [email protected] to register your business and receive your API key.

2. Choose Your Verification Mode

Mode	Use Case	Processing Time
Selfie Match	Quick face comparison (e.g., profile verification)	~2-3 seconds
ID Document	Full KYC with document data extraction	~5-10 seconds

3. Make Your First API Call

curl -X POST https://api.yeboverify.com/v1/verify/selfie-match \
  -H "X-API-Key: your_api_key" \
  -F "[email protected]" \
  -F "profilePictureUrl=https://example.com/profile.jpg"

Base URL

https://api.yeboverify.com

Authentication

All API requests require an X-API-Key header:

X-API-Key: your_api_key_here

Response Format

All responses follow this format:

{
  "success": true,
  "data": {
    // Response data here
  }
}

Error responses:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message"
  }
}

Verification Flow

Synchronous Verification (Recommended)

Both verification modes return results immediately:

┌─────────────────┐       ┌─────────────────┐
│   Your App      │       │   YeboVerify    │
└────────┬────────┘       └────────┬────────┘
         │                         │
         │  POST /v1/verify/*      │
         │────────────────────────>│
         │                         │
         │  ◄── Instant Response ──│
         │  (verification result)  │
         │<────────────────────────│

Async Verification (Sessions)

For redirect-based flows. You'll receive two webhooks during a successful run — verification.submitted the moment the user finishes uploading documents, and verification.completed once AI processing is done (~5–10s later). See Webhooks for the full event catalog.

┌─────────────────┐       ┌─────────────────┐       ┌─────────────────┐
│   Your App      │       │   YeboVerify    │       │   User Browser  │
└────────┬────────┘       └────────┬────────┘       └────────┬────────┘
         │                         │                         │
         │  POST /v1/sessions/     │                         │
         │    create               │                         │
         │────────────────────────>│                         │
         │                         │                         │
         │  ◄── Session Token ────│                         │
         │<────────────────────────│                         │
         │                         │                         │
         │                         │  Redirect to verifyUrl  │
         │─────────────────────────┼────────────────────────>│
         │                         │                         │
         │                         │  ◄── User uploads docs ─│
         │                         │<────────────────────────│
         │                         │                         │
         │  ◄ verification.submitted (immediate)             │
         │<────────────────────────│                         │
         │                         │                         │
         │                         │ (AI processing ~5–10s)  │
         │                         │                         │
         │  ◄ verification.completed (final decision)        │
         │<────────────────────────│                         │

Use verification.submitted to flip your local KYC state to "in progress" only after the user has actually uploaded documents — never on session creation, since the user could abandon. Wait for verification.completed for the approve/reject decision.

Rate Limits

Plan	Requests/minute	Verifications/month
Free	10	100
Starter	60	1,000
Business	300	10,000
Enterprise	Custom	Custom

Next Steps

• API Reference - Complete endpoint documentation
• Code Examples - Implementation examples in various languages
• Webhooks - Configure webhook notifications
• Error Codes - Complete error reference