Use this API to schedule the closure of an active savings account. The closure is not immediate — the account enters a waiting period before it is permanently closed.

Prerequisites

• The account must be in Active status.
• Pass the accountId as a path parameter and command=SCHEDULECLOSE as a required query parameter.

Example Request

POST /v1/savingsaccounts/{accountId}?command=SCHEDULECLOSE

Closure Timeline

• Upon scheduling, the account is immediately blocked and no transactions can be made.
• The account is closed on the day after the waiting period ends.
• The waiting period defaults to 30 days but can be configured by Mbanq.

Closure Options

The request body allows you to control the following behaviour at the time of closure:

• withdrawBalance — whether the remaining balance should be automatically withdrawn.
• postInterestValidationOnClosure — whether interest should be validated before the account is closed.
• paymentTypeId — the payment method to use if withdrawing the balance.
• closeReasonCodeId — the reason for closure. Use the Get Code Values API with code name ACCOUNT_CLOSE_REASON to retrieve valid reason IDs.