Inquiry Model Lifecycle
An inquiry wraps a single interaction with your customer through a single use case.
Statuses
Inquiry statuses allow you to track where individuals are in the process, and status changes trigger your configured webhooks.
Inquiries change statuses when:
- Your customer proceeds through their inquiry: starting a verification or completing the flow.
- Post-inquiry workflows apply business logic to automatically decision the inquiry or mark for manual review.
- Your organization members manually change the status of an inquiry.
- The inquiry expires.
| Status | Event Name | Description |
|---|---|---|
created | inquiry.created | Initial status. |
pending | inquiry.started | Your customer submits a document or begins a verification. |
completed / failed | inquiry.completed / inquiry.failed | Your customer moves to the completion or failure screen of the inquiry. An inquiry will be completed if all of the required verification checks pass. It will be failed if one or more of the required checks fail. |
expired | inquiry.expired | By default, inquiries in the pending state expire after 24 hours for security reasons. |
needs_review / approved / declined | inquiry.marked-for-review / inquiry.approved / inquiry.declined | These optional statuses most likely occur after the user has finished the inquiry. If you apply any post-inquiry processing in Persona (workflows or manual review), listen to these statuses to know how the user should proceed. |
Updated about 2 years ago