Inquiry Model Lifecycle

Inquiry Model Lifecycle

An inquiry wraps a single interaction with your customer through a single use case. The Lifecycle model articulates the various stages and statues that an inquiry can move through across it’s creation to conclusion. The model include four phases, some of which include multiple statuses.

Statuses

Inquiry statuses allow you to track where individuals are in the process, and status changes trigger your configured webhooks.

inquiry-lifecycle

Events change Statues

Inquiries have formal events, like inquiry.created and inquiry.approved that drive changes to the statues. The events are useful to know when building logic on persona as these events can also be used as triggers in post-inquiry processes like workflows. Inquiry events and related statuses can change when:

  1. Your end user proceeds through their inquiry: starting a verification or completing the flow.
  2. Post-inquiry workflows apply business logic to automatically decision the inquiry or mark for manual review.
  3. Your organization’s members manually change the status of an inquiry.
  4. The inquiry expires.
PhaseStatusEvent NameStatus Description
Createdcreatedinquiry.createdSet when the inquiry is first created.
Pendingpendinginquiry.startedSet when the end user submits a document or begins a verification.
Donecompletedinquiry.completedSet when end user reaches the Completed screen.
Donefailedinquiry.failedSet when end user reaches the Failed screen.
Doneexpiredinquiry.expiredSet when inquiry exceeds 24hrs, or configured duration, after inquiry created.
Post-Inquiryapprovedinquiry.approvedSet via post-inquiry processes or manual update.
Post-Inquiryneeds reviewinquiry.needs_reviewSet via post-inquiry processes or manual update.
Post-Inquirydeclinedinquiry.declinedSet via post-inquiry processes or manual update.

For additional guidance, learn more about inquiry statuses in our Help Center.

What’s the difference between Done & Post-Inquiry?

inquiry-lifecycle

While all inquiry runs will end up at some point in the Done phase, via the Completed, Failed, or Expired statuses, it only describes the inquiry from the end user perspective as they are “done” with it. But you have additional statuses you can use as part of deciding what to do with the inquiry, allowing to you move it to Approved, Needs Review, & Declined. These statuses can then be used by post-inquiry processes to drive additional logic and outcomes.

When selecting which events, and thus statues, to configure in your webhooks we strongly recommend configuring both approved & declined as they are the most actionable for your own systems.