DRUO
Get started
Accounts

List Accounts

GEThttps://api.druo.com/accounts/list

Retrieve a list of accounts associated with a business.

This endpoint supports advanced filtering and search capabilities based on the provided query parameters, as well as pagination to manage lists of connected accounts.

Query parameters

uuidstringoptional

Filter by the unique identifier of the Connected Account.

end_user_emailstringoptional

Filter by the email of the associated End User.

pageintegeroptional

The page number to return. Starts at 1.

page_sizeintegeroptional

The number of items per page. Defaults to 1000 when omitted.

Pagination · Filters

Response— Returns a paginated list.

uuidstringoptional

The Connected Account's unique identifier.

Example: acc_747536f4-1efd-4cad-91b3-cc8aaeed93e3
codestringoptional

The Connected Account's code.

Example: ACSCDSVFGH
current_statusstringoptional

The current status of the Connected Account.

Example: CONNECTED

Indicates whether the account requires validation. If true, use the Validate Account endpoint with the value in pending_account_validations.

Example: false

List of pending account validations required to connect this account. If present, use the Validate Account endpoint with the corresponding slug.

Example: [{"slug":"b8772a3a-ca25-4c01-8317-f044975a66eb","action":"CONFIRM_REQUEST_WITH_INSTITUTION"}]
remarksstringoptional

Account remarks regarding the Connected Account's status.

Example: ACCOUNT_DOES_NOT_EXIST
institutionobjectoptional

Contains the unique identifier and name of the financial institution where the Connected Account is registered.

Example: {"uuid":"ins_ff6c5094-1cd1-11ec-9621-0242ac130002","name":"Banco"}
last_4stringoptional

The last four digits of the actual account number.

Example: 4524
typestringoptional

The type of account, which determines whether the account holds value.

Example: DEPOSITORY
subtypestringoptional

The subtype of account, providing further details about the account type.

Example: SAVINGS
capabilitiesstringoptional

The capabilities available for this account, returned as a comma-separated list.

Example: PAYMENTS, BALANCE, IDENTITY, AUTHENTICATION, TRANSFERS

Indicates whether the account is configured for real-time payouts.

Example: false
end_userEndUseroptional

The complete End User object associated with this account.

disconnect_reasonstringoptional

The reason why the account was disconnected.

Example: ACTIVITY_COMPLETED
disconnection_notestringoptional

An optional note detailing the disconnection.

Example: No longer available
primary_referencestringoptional

The Connect Link's primary reference. Can be any external system value.

Example: 23423524
secondary_referencestringoptional

The Connect Link's secondary reference. Can be any external system value.

Example: bj39fhow39fhqp3f0hfae4344
metadataobjectoptional

Set of key-value pairs (up to 50 keys, names up to 40 characters, values up to 500 characters) that you can attach to the object.

Example: {"order_id":"6735"}
creation_sourcestringoptional

The creation source for this account.

Example: MERCHANT_API
date_created_gmtstringoptional

The date and time when the account was created, in ISO 8601 UTC format.

Example: 2021-11-15T23:23:38Z
date_updated_gmtstringoptional

The date and time when the account was last updated, in ISO 8601 UTC format.

Example: 2021-11-15T23:23:38Z
NextPUTDisconnect Account