verifid

Official VerifID identity verification SDK for Python.

Install

pip install verifid

Quick Start

from verifid import VerifID
from verifid.types import UserData

client = VerifID(
    api_key="sk_live_...",
    base_url="https://api.verifid.dev",  # optional
)

# Create a verification session
session = client.create_session(
    document_type="national_id",
    user_data=UserData(full_name="Ana Garcia"),
)
print(session.session_id, session.qr_url)

# Upload images
client.upload_document_front(session.session_id, base64_image)
client.upload_document_back(session.session_id, base64_image)
client.upload_selfie(session.session_id, [base64_frame1, base64_frame2])

# Trigger verification and wait for result
client.trigger_verification(session.session_id)
result = client.wait_for_result(session.session_id)

print(result.status)            # "VERIFIED" | "REJECTED"
print(result.confidence_score)  # 0.0 - 1.0
print(result.reasons)           # ["face_match_passed", ...]

Single-Device Verify

created = client.verify(
    selfie_image=selfie_b64,
    document_image=document_b64,
)

result = client.get_verification(created.session_id)

Context Manager

with VerifID(api_key="sk_live_...") as client:
    session = client.create_session()
    # ...

GDPR

# Export session data
data = client.export_session_data(session_id)

# Delete session data (right to erasure)
client.delete_session_data(session_id)

Error Handling

from verifid import VerifIDError, RateLimitError

try:
    client.create_session()
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except VerifIDError as e:
    print(f"API error: {e.status} — {e}")

Configuration

Sandbox

Use a sk_test_* key to get mock results without real ML processing.