Customization Options

Customize verification links to match your brand, control user experience, and integrate seamlessly with your workflows.

Available Options

Option	Type	Description	Default
`type`	string	Verification type: document_only, standard, enhanced, premium	enhanced
`expires_in`	string	Link expiration: 24h, 7d, 30d, never	7d
`single_use`	boolean	If true, link can only be used once	true
`target_language`	string	ISO language code for result translation (e.g., "es", "fr", "ja")NEW	en
`addons`	string[]	Array of add-on IDs: multi_script_ocr, deepfake_detection, age_attestation, voice_biometric	[]
`send_email`	boolean	Send verification request email via Owl EyesNEW	false
`recipient_email`	string	Email address(es) for verification request (comma-separated)NEW	null
`redirect_url`	string	URL to redirect user after completion	null
`webhook_url`	string	URL to receive webhook notifications	Account default
`sender_name`	string	Custom sender name displayed to users (requires business verification)	null
`reference_id`	string	Your internal ID to track this verification	null
`metadata`	object	Custom key-value pairs (max 10 keys)

Expiration Settings

Control how long your verification links remain valid:

Security Note

Use shorter expiration times for sensitive verifications. Links that “never expire” should be used carefully and monitored.

Redirect Configuration

After a user completes verification, redirect them back to your application:

We append query parameters to your redirect URL:

Branding Options

Customize the look and feel of the verification experience (Premium feature):

White Label

Full white-label (removing Owl Eyes branding) is available on Enterprise plans. Contact Owl Eyes Team for more information.

Results Language TranslationNEW

Receive verification results translated into your preferred language. The original document is processed in its native script and language, then the extracted data is automatically translated.

Example use cases:

Receive Korean passport data translated into Spanish for your Spanish-speaking support team
Process Japanese driver's licenses with results in French for your EU operations
Verify Arabic IDs with English result output for US-based compliance review

Pair with Multi-Script OCR

For best results with non-Latin documents, combine results translation with the Multi-Script OCR add-on (+$0.25) for enhanced accuracy.

Email Delivery via Owl EyesNEW

Let Owl Eyes send verification request emails directly to your recipients. This saves you from implementing your own email infrastructure and ensures professional, trusted delivery.

What's included in the email:

Verification link with secure one-click access
Your verified business name with trust badge (if verified)
Security warnings about phishing and fraud
Link for recipients to report suspicious activity

Verified Businesses Get Trust Badges

When you complete business verification (KYB), your emails include a verified business badge, significantly increasing recipient trust and verification completion rates.

Email Deliverability

Emails are sent from verification@updates.owl-eyes.com. If recipients don't receive the email, advise them to check their spam or junk folder.

Verification Add-ons

Enhance your verification with specialized capabilities:

Add-on	Price	Description
`multi_script_ocr`	+$0.25	Enhanced OCR for Arabic, Cyrillic, Chinese, Japanese, Korean, and other non-Latin scripts
`deepfake_detection`	+$0.30	AI-powered detection of synthetic or manipulated media
`age_attestation`	+$0.20	Verify minimum age (18+, 21+, etc.) without storing date of birth
`voice_biometric`	+$0.35	Voice pattern analysis for additional identity verification

Document Restrictions

Limit which document types or countries are accepted:

Metadata

Attach custom data to verifications for your own tracking:

Metadata is included in:

Webhook payloads
API responses when fetching verification details
Dashboard exports (CSV)

Previous← Creating Links NextSharing Best Practices →