Tracking Verification Status
Monitor verification links in real-time through the dashboard, webhooks, or API polling.
Status Lifecycle
Every verification link goes through a defined lifecycle:
Created→Pending→Processing→Verified
| Status | Description | Can Transition To |
|---|---|---|
| created | Link generated, not yet accessed | pending, expired |
| pending | User has accessed the link | processing, abandoned, expired |
| processing | User submitted, analysis in progress | verified, review_required, failed |
| verified | All checks passed (terminal) | — |
| review_required | Flagged for manual review | verified, failed |
| failed | Verification failed (terminal) | — |
| expired | Link expired before completion | — |
| abandoned | User left without completing | pending (if returned) |
Dashboard Monitoring
The Owl Eyes dashboard provides real-time visibility into all your verifications:
- Verifications List — Sortable, filterable table of all verifications
- Status Filters — Quick filters for each status type
- Search — Find by reference ID, email, or verification ID
- Real-time Updates — Status changes appear automatically
- Export — Download verification data as CSV
Webhook Notifications
The recommended way to track status changes is through webhooks. See the Webhooks Guide for full details.
Webhook Payloadjson
Loading...
API Polling
If webhooks aren't suitable for your use case, you can poll the API for status updates:
polling-example.tstypescript
Loading...
Rate Limiting
API polling is subject to rate limits (100 requests/minute). For real-time updates, webhooks are strongly recommended.Listing Verifications
Query your verifications with filters:
list-verifications.tstypescript
Loading...
Analytics & Metrics
The dashboard provides aggregate metrics:
| Metric | Description |
|---|---|
| Completion Rate | Percentage of links that result in completed verifications |
| Success Rate | Percentage of completed verifications that passed |
| Average Time | Average time from link creation to completion |
| Drop-off Points | Where users abandon the verification flow |
| Fraud Rate | Percentage flagged as potential fraud |
Access detailed analytics in Dashboard → Analytics.