Skip to main content

Result codes

The IDnow API returns reason codes in the reason field of identificationprocess and in webhook payloads. These codes describe why an identification ended in a particular state.

This section is the canonical reference for those codes. Pages are split by lifecycle event so you can deep-link to the specific list relevant to your integration.

  • Status and result values — high-level lifecycle status (Created, Started, Pending, …) and final result (SUCCESS, FRAUD_SUSPICION_CONFIRMED, …).
  • Abort reasons — codes returned when the user aborts the identification before completion (AutoIdent + VideoIdent).
  • Cancel reasons — codes returned when an agent or the system cancels the identification (AutoIdent, VideoIdent, system-set, eID).
  • Fraud-suspicion reasons — codes returned when an identification ends in FRAUD_SUSPICION_CONFIRMED (AutoIdent + VideoIdent).
note

The same reason value is delivered through the GET Identification response and through webhooks. Use this reference for both.