API Documentation

Authorization: Bearer YOUR_API_KEY

curl -X POST https://api.klarifyid.online/v1/verify/document \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_image": "base64_encoded_image",
    "document_type": "passport",
    "country": "US"
  }'

{
  "success": true,
  "verification_id": "ver_1a2b3c4d5e6f",
  "status": "verified",
  "confidence": 0.987,
  "extracted_data": {
    "document_type": "passport",
    "document_number": "123456789",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-01-15",
    "expiry_date": "2030-01-15",
    "nationality": "US",
    "sex": "M"
  },
  "fraud_score": 2,
  "checks": {
    "document_authentic": true,
    "mrz_valid": true,
    "face_detected": true,
    "tampering_detected": false
  }
}

curl -X POST https://api.klarifyid.online/v1/verify/selfie \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "selfie_image": "base64_encoded_selfie",
    "document_photo": "base64_encoded_document_photo",
    "liveness_check": true
  }'

{
  "success": true,
  "verification_id": "ver_2b3c4d5e6f7g",
  "status": "verified",
  "face_match": {
    "matched": true,
    "confidence": 0.952,
    "similarity_score": 0.89
  },
  "liveness": {
    "is_live": true,
    "confidence": 0.978,
    "spoofing_detected": false
  }
}

curl -X GET "https://api.klarifyid.online/v1/risk/email?email=user@example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "email": "user@example.com",
  "risk_score": 8,
  "is_disposable": false,
  "is_free_provider": false,
  "domain_age_days": 3650,
  "suspicious": false
}

curl -X GET "https://api.klarifyid.online/v1/risk/ip?ip=203.0.113.42" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "ip": "203.0.113.42",
  "risk_score": 15,
  "country": "US",
  "city": "San Francisco",
  "is_vpn": false,
  "is_proxy": false,
  "is_tor": false,
  "is_hosting": false,
  "abuse_score": 2
}