Skip to main content
DELETE
Cancel KYC Validation

Overview

This endpoint allows you to cancel a KYC validation that is in pending, in_progress, or in_review status. When cancelled:
  • The validation status changes to cancelled
  • The Gu1 session is terminated (the user can no longer access the verification URL)
  • The validation is marked as not current (isCurrent: false)
  • You can create a new validation for the same entity afterward
  • Usage recorded when the session started is not refunded
This action cannot be undone. Usage is consumed when the session starts and is not refunded when cancelled. The user will need to start a new process if identity verification is still required.

When to Use This

  • User requested cancellation: Customer no longer wants to complete verification
  • Incorrect data: Entity information was entered incorrectly
  • Duplicate validation: Validation was created by mistake
  • Process restart needed: Need to start fresh with new verification session

Request

Endpoint

Path Parameters

string
required
The validation ID to cancel

Headers

Body Parameters

string
required
Reason for cancelling the validation (minimum 5 characters)Type: string (min length: 5)Example: "User requested to cancel the verification process"

Response

Success Response (200 OK)

Returns the updated validation object with cancelled status:

Example Request

Error Responses

Validation Not Found (404)

Invalid Status (400)

Validation can only be cancelled if status is pending, in_progress, or in_review:

Invalid Reason (400)

Reason must be at least 5 characters:

Important Notes

When you cancel a validation, Gu1 closes the session and the verification URL stops working. The execution is consumed when the session starts; cancelling, abandoning, or allowing the validation to expire does not refund that usage.
The cancellation reason is saved in the validation metadata and audit logs. This helps maintain compliance and track why validations were cancelled.
You cannot cancel validations that are already approved, rejected, expired, abandoned, or cancelled. Only pending, in_progress, or in_review validations can be cancelled.
After cancelling, you can create a new KYC validation for the same entity. The previous validation will remain in the history with cancelled status.

Next Steps

Create KYC Validation

Start a new verification session

Check Verification Status

Query validation results