Tracking References
How VerifiMe tracking references work and what they tell you
What is a Tracking Reference?
A tracking reference is a unique identifier (UUID) that represents a customer's verification session. It tracks the customer's progress through data entry in the VerifiMe portal.
Status Lifecycle
| Status | Meaning | When |
|---|---|---|
| Inactive | Tracking reference created, customer has not started | After POST /v1/user/invite returns |
| Active | Customer has started the verification process | Customer clicks the widget button or scans the QR code |
| Completed | Customer has submitted all required information | Customer submits the verification form |
Important: "Completed" means the customer finished data entry. It does not mean identity is verified or risk assessment is complete. See Integration Flow for the full two-phase model.
What Tracking Status Does NOT Tell You
- ❌ Whether identity verification passed or failed
- ❌ Whether biometric checks were completed
- ❌ Whether DVS validation succeeded
- ❌ What the risk assessment result is
- ❌ What entity type was verified
- ❌ Whether the verification is approved
Tracking status only indicates customer data entry progress.
When to Check Tracking Status
Widget Checks Automatically: The VerifiMe widget polls the tracking status endpoint every 3-5 seconds automatically. You do not need to poll this endpoint directly.
Manual Polling (Optional): You can optionally poll GET /v1/user/signup/tracking/{trackingReference}/status if you need to check status outside of widget context.