Cancel a capital deposit case

Use the API to cancel a capital deposit case.

Prerequisites

All of the following conditions must be met:

1. The capital deposit case status is WaitingForInitialRequirements.
2. Your shareholders can't have the shareholder status CapitalTransferred.
3. The shareholder account's booked balance is zero (0).

Early-stage cancellation

You can cancel a capital deposit case through the API only during the early stage of the process. The mutation is rejected once the case has progressed beyond WaitingForInitialRequirements or all shareholders have completed their capital transfers.

Guide

1. Call the cancelCapitalDepositCase mutation.
2. Add the capital deposit case ID (line 2).
3. Add the success payload and any information you'd like to receive (line 3).
4. Add rejections (not shown).

Mutation

Open in API Explorer

mutation CancelCase {
  cancelCapitalDepositCase(input: { id: "$CAPITAL_DEPOSIT_CASE_ID" }) {
    ... on CancelCapitalDepositCaseSuccessPayload {
      __typename
      capitalDepositCase {
        statusInfo {
          status
          ... on CapitalDepositCaseCanceledStatusInfo {
            reasonCode
          }
        }
      }
    }
  }
}

Payload

The payload confirms the capital deposit case status changed to Canceled and returns the reason code.

{
  "data": {
    "cancelCapitalDepositCase": {
      "__typename": "CancelCapitalDepositCaseSuccessPayload",
      "capitalDepositCase": {
        "statusInfo": {
          "status": "Canceled",
          "reasonCode": "KYCIssue"
        }
      }
    }
  }
}

What happens after cancellation

When you cancel a capital deposit case, all associated accounts are automatically closed: shareholder accounts and the future company account. These accounts receive a closure reason code.

You can subscribe to the CapitalDepositCaseEvent.Canceled webhook to receive notifications when a capital deposit case is canceled. The cancelation reason code is also available directly on the capital deposit case, in the CapitalDepositCaseCanceledStatusInfo type.

Completed capital deposits

When a capital deposit is successfully completed, shareholder accounts are closed with the reason code CapitalDepositCompleted.

Backward compatibility

Capital deposit cases and accounts affected before 2 April 2026 may still show the deprecated closure reason code CapitalDepositReason.