Cancel a capital deposit case

Cancel an in-progress capital deposit case with the API, which automatically closes the associated accounts.

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).

Past the API window

After shareholders transfer their capital funds, the case can no longer be canceled with the API. You can still contact Swan and ask to cancel the case.

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 cancelation

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

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.

Retroactive migration

Cases canceled before 2 April 2026 were migrated retroactively to the current reason codes.