Account Status

This page explains the conditions of an account and how to track them. The condition tells whether the account can already operate and with which restrictions, and it changes as the account moves through processing. A successful API response only confirms that the request was technically received, not that the registration was approved: the BU must treat an account as verified only when its condition is Verified.

Account conditions

ConditionValue in the systemMeaningWhat the BU should do
Under reviewCreatedAccount created and sent to the KYC and AML process.Do not treat the account as ready to operate, and wait for the final result.
LimitedLimitedAccount with restrictions.Operate only within the enabled limits and products. If documents are pending, guide the end customer to regularize them.
VerifiedVerifiedKYC and AML completed with approval.Operate according to the contracted products and limits.
BlockedBlockedRegistration, document, regulatory, security or risk restriction.Do not operate until the account is regularized.

Equivalence in the policy and in customer communication: the Limited condition is called "Temporary registration pending" and the Verified condition is called "Approved".

Closing is not an account condition. Track it by the status of the UpdateCloseAccount webhook: status 5 (Approved) means the account is closed. When the closing is completed, the account type (Account.Type) changes to Closed (26), without generating the UpdateAccount webhook.

The numeric code of each condition is in Code Mapping. The time an account takes to leave Under review is in SLAs.

Account path

flowchart LR
  A[Request received] --> B[Under review]
  B --> C[Verified]
  B --> D[Limited]
  D -- Documents regularized --> C
  B --> E[Blocked]
  C --> E
  D --> E
  E -- Cause regularized --> P[Condition before the block]

The closing follows another path, reported by the UpdateCloseAccount webhook:

flowchart LR
  A["Closing request"] --> B["UpdateCloseAccount webhook"]
  B -->|"5 Approved"| C["Account closed"]
  B -->|"4 Disapproved"| D["Closing request disapproved"]
  B -->|"2 Error"| E["Account not closed: resolve the condition"]
  B -->|"0 Created, 1 Processing, 3 Pending, 6 AutomaticClosingRequest"| F["Wait for the next status"]

How to track the condition

There are two ways to track it, and the best practice is to use both. The account webhook notifies the BU when the condition changes, and the BU should update the account in its own system from it. The GetAccount query returns the data of one account in real time, and is useful to check a specific account, identified by the AccountKey or by the Identifier and/or TaxNumber, or to reconcile accounts with no final result. The fields and examples are in the API Reference, and the events are in Webhooks. Handle webhooks idempotently, because the same event may arrive more than once.

Important rules

A Limited account with pending documents must not be presented to the end customer as Verified. The details are in Pending Documents.

A Blocked account can operate again after the cause is regularized, as explained in Blocking and Unlocking.

Creating a closing request does not close the account. The account is considered closed only when the UpdateCloseAccount webhook carries status 5 (Approved), as explained in Closing an Account.


Did this page help you?