List organization bank accounts

post https://api-stage.bill.com/api/v2/List/BankAccount.json

List organization bank account objects.

See Search operations with lists to learn about pagination, sorting, and filtering.

BILL encrypts and securely stores bank account and routing number information. In the response, only the last four digits are visible.

Response

Response body

object

response_status

integer

Response status.

0: Success response
1: Error response. Only error_code and error_message is returned in response_data.

response_message

string

Response status.

Success: Success response
Error: Error response. Only error_code and error_message is returned in response_data.

response_data

array of objects

response_data

object

entity

string

Object type. Set as BankAccount.

string

BILL-generated ID of the organization bank account. The value begins with bac. You can filter with this field.

isActive

string

Object visibility status. Inactive objects are hidden by default in the BILL web app. You can filter with this field.

1: Active
2: Inactive

createdTime

string

Created date and time. You can filter with this field.

updatedTime

string

Updated date and time. You can filter with this field.

bankName

string

Bank name

nameOnAcct

string

Full name on bank account

accountNumber

string

Bank account number

routingNumber

string

Bank routing number

usersId

string

BILL-generated ID of the user. You can filter with this field.

chartOfAccountId

string

BILL-generated ID of the chart of accounts. The value begins with 0ca. This is an accounts tracking object. You can filter with this field.

status

string

Bank account verification status. You can filter with this field.

0: Not verified
1: Verified
2: Pending
3: Blocked
4: Expired
5: Invalid

primaryAP

boolean

Set as true if this is the primary bank account for Accounts Payable (AP). You can filter with this field.

primaryAR

boolean

Set as true if this is the primary bank account for Accounts Receivable (AR). You can filter with this field.

isSavings

boolean

Customer bank account type. You can filter with this field.

true: Savings account
false: Checking account

isPersonalAcct

boolean

Customer bank account owner type. You can filter with this field.

true: Personal account
false: Business account

autoAdminAuth

boolean

Set as true if Administrator users are automatically nominated to use this bank account. You can filter with this field.

dateEstablished

string

Bank account established date. The value is in the YYYY-MM-DD format. You can filter with this field.

verificationLevel

string

Bank account verification level. You can filter with this field.

0: None
1: Relaxed fraud verification
2: Strict fraud verification
3: Verified

bankBalance

number

Bank account balance. You can filter with this field.

verifyStatus

string

Bank account verification status. You can filter with this field.

0: ACH verified
1: Instant Transfer availability check in progress
2: Instant Transfer approval in progress
3: Instant Transfer verified. If Instant Transfer fails, status reverts to ACH verified.

error_code

string

Error code (only when response_status is 1)

error_message

string

Error message (only when response_status is 1)

xxxxxxxxxx
curl --request POST \
     --url https://api-stage.bill.com/api/v2/List/BankAccount.json \
     --header 'accept: application/json' \
     --header 'content-type: application/x-www-form-urlencoded' \
     --data 'data={"start":0,"max":999}'

200Success