bankAccount.list

Retrieve a comprehensive list of all Bank Account entities within a Subject Record.

POST http://api.kompliant.com/bankAccount.list (OpenAPI specification)

Usage Info

This method returns all Bank Account entities associated with a specific Subject Record, providing a complete view of financial accounts linked to the record. Each account's details are included, with sensitive information masked by default. Use this method when displaying financial information for review, selecting accounts for transactions, or performing comprehensive financial assessments.

Request

Authentication: KSig1-HMAC-SHA256

Parameters

ParameterTypeRequiredDescription
subject_record_idstringYesThe identifier for the Subject Record from which to list all the Bank Account objects.
show_sensitive_dataobjectNoA boolean value that if true, indicates that sensitive data should shown. If the parameter is not provided, the value defaults to false and the sensitive data will be masked.

The sensitive data for the Bank Account is the bank_account_number field.

Example

{
  "subject_record_id": "sr_57WfSCnafMnxDiWMKcy3EW",
  "show_sensitive_data": false
}

Response

Data

ParameterTypeDescription
bank_accountsarrayAn array of bank account objects that contain information about Bank Accounts within the Subject Record.

If the Subject Record has no Bank Account objects, the array will be empty.

Object Parameters

ParameterTypeDescription
bank_account_idstringThe ID of the Bank Account.
bank_account_ownership_typestringThe type of ownership of the bank account. Must be one of the BANK_ACCOUNT_OWNERSHIP_TYPES .
bank_account_typestringThe type of bank account. Must be one of the BANK_ACCOUNT_TYPES .
bank_routing_numberstringThe routing number that identifies the bank where the account is.

This field must be 9 characters long and only contain digits [0-9].
bank_account_numberstringThe account number for the bank account.

This field must only contain digits [0-9].
bank_namestringThe name of the bank.

Note: Some workflows, such as the Business-Application-type workflow, will override this value by using the bank_routing_number to find the publicly available bank name.
created_atstringThe date-time when the Bank Account was created.

The value will be in ISO 8601 date and time format (YYYY-MM-DDTHH:mm:ss.SSSZ).
updated_atstringThe date-time when the Bank Account was last updated. If there has been no update, the value will be the same as the created_at value.

The value will be in ISO 8601 date and time format (YYYY-MM-DDTHH:mm:ss.SSSZ).

Example

{
  "meta": {
    "status": "SUCCESS",
    "trace_id": "trc_1mGNOxZNPCBqqplXUy54wh",
    "version": "2025-03-24"
  },
  "data": {
    "bank_accounts": [
      {
        "bank_account_id": "ba_6zNzQZHSf26V83BO3uW6dS",
        "bank_account_ownership_type": "BUSINESS",
        "bank_account_type": "CHECKING",
        "bank_routing_number": "021000021",
        "bank_account_number": "XXXXXXX123",
        "bank_name": "JPMORGAN CHASE BANK, NA",
        "created_at": "2025-01-18T12:01:12.179Z",
        "updated_at": "2025-01-18T12:01:12.179Z"
      },
      {
        "bank_account_id": "ba_6ITSh3KdGAOupyRX7K2Qpv",
        "bank_account_ownership_type": "BUSINESS",
        "bank_account_type": "GENERAL LEDGER",
        "bank_routing_number": "123006800",
        "bank_account_number": "XXXXXXX789",
        "bank_name": "WELLS FARGO BANK NA",
        "created_at": "2025-01-19T05:24:53.848Z",
        "updated_at": "2025-01-19T05:24:53.848Z"
      }
    ]
  }
}

Errors

Error CodeHTTP CodePossible Cause
BAD_REQUEST400Required parameters not provided.
Invalid values provided.
ENTITY_NOT_FOUND400The bank_account_id provided does not exist.