Webhook Events

A complete reference of all webhook events you can subscribe to.

Event Types

Owl Eyes sends the following webhook events:

Event Type	Description
`verification.started`	User started a verification
`verification.completed`	Verification completed successfully
`verification.failed`	Verification failed
`verification.review_required`	Manual review is required
`verification.expired`	Verification link expired without completion
`verification.abandoned`	User abandoned the verification
`review.completed`	Manual review decision was made

Triggered when a user begins a verification flow.

Triggered when a verification completes with a "verified" status.

Triggered when a verification fails after all retry attempts.

Reason	Description
`document_unreadable`	Document text could not be extracted
`document_expired`	Document has expired
`document_suspected_fraud`	Document appears to be fraudulent
`face_mismatch`	Selfie doesn't match document photo
`liveness_failed`	Liveness check detected spoofing
`age_verification_failed`	User is under the required age
`max_attempts_exceeded`	User exceeded maximum retry attempts

Triggered when a verification requires manual review.

Triggered when a verification link expires without being completed.

Triggered when a user starts but doesn't complete verification (after 30 minutes of inactivity).

Triggered when a manual review decision is made.

Example code for handling different event types: