DocumentationAPI Reference
DocumentationAPI ReferenceStatus

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.

26892689

Inquiries change statuses when:

  1. Your customer proceeds through their inquiry: starting a verification or completing the flow.
  2. Your organization members approve, decline, or mark the inquiry for review.
  3. 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.