Close Account

Use this API to permanently close a savings account. Once closed, the account is deactivated and no further transactions can be performed.

Prerequisites

  • The account must be in Active status.
  • Pass the savingsAccountId as a path parameter and command=close as a required query parameter.
  • A valid closure reason code must be provided in the request body. Use the Get Code Values API with code name ACCOUNT_CLOSE_REASON to retrieve the list of valid reason codes.

Example Request

POST /v1/savingsaccounts/{savingsAccountId}?command=close

Common Closure Reasons

Accounts are typically closed for one of the following reasons:

  • Client request
  • Account inactivity
  • Compliance or regulatory requirements

Note: If you want to schedule a closure in advance with a waiting period, use the Schedule Account Closure endpoint instead.

Path Params
integer
required
Defaults to 123

The Id associated to the account.
Example: 123

Query Params
string
required
Defaults to close

Specifies the action to be performed.
Use close to initiate the account closure process.

Body Params
integer
Defaults to 5100

The code ID representing the reason for account closure.
To retrieve valid code IDs, use the Get Code Values API:
/v1/codevalues?codeName=ACCOUNT_CLOSE_REASON

This API provides a list of available close reasons associated with the code name ACCOUNT_CLOSE_REASON.
Example: 5100

string

An optional note or comment to be associated with the account closure.
Example: Account closed due to customer request

string

The date on which the account is to be closed.
Format must match the value provided in dateFormat.
Example: 01 April 2025

string

The format of the date fields used in the request.
Example: dd MMMM yyyy

string

The locale used for parsing dates and formatting.
Example: en

boolean

Indicates whether the remaining account balance should be withdrawn during closure.
Example: false

boolean

Indicates whether to perform interest posting validation during closure.
Example: true

boolean

Specifies whether the account can be closed even if it has a negative balance.
Example: false

Headers
string
required

The ID of your banking instance visible in the MBANQ Console.

Response

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json