verifid 1.0.0

Official VerifID identity verification SDK for Python

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

Param	Default	Description
api_key	(required)	Your API key (sk_live_* or sk_test_*)
base_url	https://api.verifid.dev	API base URL
timeout	30.0	Request timeout in seconds

Sandbox

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