Skip to main content
An Identity Verification Required error is returned when an orchestration cannot proceed because the profile’s identity has not been approved. Endpoints that can return this error: Create Orchestration. The error includes meta fields that identify the specific identity and its current status so you can fetch details or route the end user to complete verification:
  • ref_path: The path to the identity resource — call GET {ref_path} to retrieve identity details and determine what requirement is blocking.
  • identity_id: The UUID of the identity that must be approved before the orchestration can proceed.
  • current_status: The identity’s current status (e.g. PENDING, DENIED).
The orchestration is not created. Once the identity is approved, retry the request using the same ref_id for idempotency.
Questions? Contact Support.