BridgeConnecteurStable

List accounts (Bridge)

Lists Bridge bank accounts accessible to a user, with item filtering and pagination.

Vue d’ensemble

List Bridge accounts returns bank accounts accessible to a user and can restrict the search to a specific bank connection.

By default, accounts with data_access = disabled are removed from the output to avoid accidentally using them in subsequent steps.

  • Supply item to limit accounts to a connected bank.
  • include_disabled = false is the recommended default behavior.
  • Balances and other amounts are exposed in minor units of the account currency.

Process example

User Bridge
Lister les comptes bancaires (Bridge)
Account Bridge

Exemple simplifié d’utilisation de Lister les comptes bancaires (Bridge) dans un processus Ormuz.

Data resolution

The node applies the following rules from the supplied objects and filters.

DataSource or rule
Userbridge_user.uuid.
Banque optionnelleitem.id when item is supplied.
Disabled accountsExcluded unless include_disabled = true.
Paginationlimit, starting_after, has_more, and next_uri.
MontantsConverted from the provider format to common.amount in minor units according to the account currency.

Parameters 6

Contexte principal

Objects and configuration that determine the Bridge operation.

extension_config_idRequisref(extension_config:bridge)
Active Bridge configuration used for this operation. It determines the Bridge API credentials and environment; the merchant remains the merchant of the current process.
bridge_userRequisBridge user
Bridge user representing the person whose bank accounts must be connected, accessed, or verified. Usually obtain it with bridge.ensure_user rather than constructing the object manually.
itemOptionnelBridge item
Bridge bank connection (item) to retrieve or use as a filter. An item represents a user's relationship with a financial institution and may contain multiple accounts.

Filters and pagination

Parameters that bound banking-data lists and synchronizations.

include_disabledRequisboolean
Includes accounts whose data_access is disabled. By default they are excluded so subsequent steps work only with accounts whose data remains accessible.
limitRequisinteger
Maximum number of items requested from Bridge for this page. A smaller value reduces the returned volume; use has_more and next_uri to determine whether additional results exist.
starting_afterOptionnelstring
Bridge pagination cursor used to continue a list after an item already received. Use the value from the previous page rather than a locally calculated index.

Outputs 3

Banking data

Bank-aggregation or verification objects available to subsequent steps.

accountsBridge account[]
Bridge bank accounts accessible to the user or matching the requested filter. Banking information in these objects is classified as sensitive.

Pagination

Indicators used to continue a Bridge list.

has_moreboolean
Whether another page of Bridge results is available.
next_uriOptionnelstring
Pagination URI supplied by Bridge to continue the list. It is null when no additional page is available.

Behavior

Define the scope

The node works on all accounts of the bridge_user or only those belonging to the supplied item.

Read a page

Bridge returns a page according to limit and the optional cursor.

Filter access

Disabled accounts are removed unless explicitly requested through include_disabled.

Expose pagination

The final page is accompanied by has_more and next_uri.

Limits and responsibilities

  • A disabled account may still be returned explicitly with include_disabled = true, but doing so does not restore data access.
  • The node does not automatically traverse every page.
  • IBANs and banking data are sensitive even though amounts themselves use the normalized monetary type.

Troubleshooting

An account disappeared from the list

Check whether it has data_access = disabled. Temporarily enable include_disabled only to diagnose its state.

More accounts than expected

Supply the item for the bank you want to target instead of listing all accounts for the user.

The list is incomplete

Check has_more and use the pagination cursor to retrieve the next page.

Reference

include_disabledReturned accounts
false (default)Comptes dont data_access reste exploitable.
trueAlso includes accounts marked disabled by Bridge.