Skip to main content
POST
Change account status

Overview

Toggle status of an existing account between OPEN and CLOSED. What CLOSED means in practice: the status is a registry state of the account record. Note that no account status stops senders in SEPA - any bank can still initiate a payment to any IBAN, and such payments will arrive. The standard handling for funds arriving to a closed account is to return them to the sender with reason code AC04 (closed account) via the return endpoints. What the platform does with a CLOSED account:
  • Payment processing is not affected: inbound payments to the IBAN are still received and processed, and outbound payments from it are still accepted. Blocking or returning such payments is your decision and your action.
  • The IBAN is removed from your Verification of Payee directory automatically, so VoP checks against it no longer return a match. If you maintain the VoP directory separately (accounts not registered through the account service), remove or update the entry yourself.

Path Parameters

id
integer<int64>
required

ID

Body

application/json

Request to change account status

status
enum<string>
required

New account status (OPEN or CLOSED)

Available options:
OPEN,
CLOSED
Example:

"CLOSED"

Response

Account status changed successfully

Account information response

id
integer<int64>
required

Internal account identifier

Example:

1

clientAccountId
string
required

Client's internal account ID

Example:

"acc_001"

iban
string
required

International Bank Account Number

Example:

"LT121000011111111111"

accountType
enum<string>
required

Type of account

Available options:
PRIVATE,
LEGAL
Example:

"PRIVATE"

accountHolderName
string
required

Name of the account holder

Example:

"Jane Doe"

status
enum<string>
required

Account status

Available options:
OPEN,
CLOSED
Example:

"OPEN"

createdAt
string
required

Account creation timestamp

Example:

"2025-09-10T13:43:40.758Z"

updatedAt
string
required

Last update timestamp

Example:

"2025-09-10T13:55:40.758Z"

ibanMetadata
object

International Bank Account Generation Metadata

accountHolderNameAliases
string[] | null

Optional alternative names or identifiers to improve matching (e.g., acronyms, short forms like "IBM" for "International Business Machines")

Example:
organisationIdentification
object | null

Organisation identification details (for LEGAL accounts)

Last modified on September 2, 2026