Skip to main content

Status and result values

The IDnow API uses two top-level fields to describe an identification's state:

  • status — where the identification is in its lifecycle (CreatedStartedPendingReviewFinished, plus terminal states Cancelled, Aborted, Archived).
  • result — the outcome of the identification once it reaches Finished.

Status values

StatusDescription
CreatedIdentification request created; waiting for the user to start
StartedUser has started the identification process in the app
PendingUser has completed the in-app flow; awaiting review
ReviewIdentification data is currently being reviewed
FinishedReview complete; a final result is available
CancelledCancelled by an IDnow agent (e.g., inconclusive data)
AbortedUser quit the identification process before completing
ArchivedIdentification stored in archive
note

Cancelled and Aborted identifications can be retried using the same IdentID.

Result values

Result values are set on Finished identifications. Interim values may appear while a review is in progress.

ResultFinal?Description
SUCCESSYesIdentity verified successfully
SUCCESS_DATA_CHANGEDYesIdentity verified; some fields were corrected by the reviewing agent
FRAUD_SUSPICION_CONFIRMEDYesIdentity verification rejected due to confirmed fraud suspicion
CANCELEDYesCancelled by an agent — e.g., poor image quality, expired document, or unreadable data
CHECK_PENDINGNoAutomated checks were inconclusive; identification is awaiting manual agent review
FRAUD_SUSPICION_PENDINGNoFraud indicators detected; identification is awaiting senior agent review before final decision
caution

Never treat CHECK_PENDING or FRAUD_SUSPICION_PENDING as a final outcome. Always wait for a Finished result before acting.