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 (Created→Started→Pending→Review→Finished, plus terminal statesCancelled,Aborted,Archived).result— the outcome of the identification once it reachesFinished.
Status values
| Status | Description |
|---|---|
Created | Identification request created; waiting for the user to start |
Started | User has started the identification process in the app |
Pending | User has completed the in-app flow; awaiting review |
Review | Identification data is currently being reviewed |
Finished | Review complete; a final result is available |
Cancelled | Cancelled by an IDnow agent (e.g., inconclusive data) |
Aborted | User quit the identification process before completing |
Archived | Identification 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.
| Result | Final? | Description |
|---|---|---|
SUCCESS | Yes | Identity verified successfully |
SUCCESS_DATA_CHANGED | Yes | Identity verified; some fields were corrected by the reviewing agent |
FRAUD_SUSPICION_CONFIRMED | Yes | Identity verification rejected due to confirmed fraud suspicion |
CANCELED | Yes | Cancelled by an agent — e.g., poor image quality, expired document, or unreadable data |
CHECK_PENDING | No | Automated checks were inconclusive; identification is awaiting manual agent review |
FRAUD_SUSPICION_PENDING | No | Fraud 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.