Verification Check Decision Flow
This page displays the complete decision flow for the /verifications/check endpoint in full detail.
Navigation
- Scroll horizontally and vertically to explore the entire flow
- Use browser zoom (
Ctrl/Cmd +/-) to adjust the diagram size - Return to Verification Check API documentation
Flow Summary
The verification check endpoint processes requests through multiple decision points:
- Validation & Health Checks - Validates input, checks rate limits, and service health
- Identity Lookup - Searches for existing VeriMe account and verification status
- Policy Matching - Determines if the subject meets the requested verification policy
- Voucher Management - Handles pending vouchers (resend, supersede, or continue)
- Auto-Issue Logic - Automatically issues vouchers when configured and conditions are met
- Guardrails - Enforces spending caps and delivery requirements
Response Outcomes
Success States (Green nodes)
- VERIFIED - Subject has valid verification meeting policy requirements
- VOUCHER_ISSUED - New verification voucher created and queued for delivery
Pending States (Blue nodes)
- PENDING_VOUCHER - Active voucher exists, awaiting completion
- NOT_FOUND - Subject not found, action recommended
Error States (Red nodes)
- 422 - Invalid request parameters
- 429 - Rate limit exceeded
- 402 - Payment/spending limits reached
- 503 - Service unavailable or delivery channel issue
See Also
- Verification Check API Documentation - Complete endpoint documentation
- OpenAPI Reference - Interactive API specification
- Architecture Overview - System architecture and design