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.
- Your organization members approve, decline, or mark the inquiry for review.
- 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. |
expired | inquiry.expired | By default, inquiries in the pending state expire after 24 hours. |
needs_review / approved / declined | inquiry.marked-for-review / inquiry.approved / inquiry.declined | Possible when your team member marks decisions the inquiry in dashboard; your system calls the API; a workflow action runs. |
Updated over 2 years ago