The bank account object

Represents a verified checking or savings account at a U.S. bank.

Bank account objects must be linked with an employee, contractor, or company. A company must have a linked bank account in order for Check to automatically withdraw funds to fund payrolls. An employee or contractor must have a linked bank account in order for Check to pay them using direct deposit.

Check will validate that either a raw_bank_account object or a plaid_bank_account object is included.

In this API, Check performs basic validation only on the account and routing numbers. It is your responsibility to confirm that the account and routing numbers you pass are valid. Generally, these numbers should be verified by another service (such as Plaid) and not keyed in by a user. If you would like Check to perform bank account verification, we offer Check Onboard, which implements Plaid verification for employee account creation and updates.

{
  "id": "bnk_abc",
  "employee": "emp_xyz",
  "raw_bank_account": {
    "institution_name": "Chase",
    "account_number": "112233445",
    "routing_number": "011401533",
    "subtype": "checking"
  },
  "metadata": {}
}

Attribute

Description

id
string

Unique identifier for the bank account.

employee
string

ID of the employee on the account.

company
string

ID of the company on the account.

contractor
string

ID of the contractor on the account.

raw_bank_account
object

Structured information about the bank account.

institution_name
string

The name of the bank holding the account.

account_number
string

The account’s account number.

routing_number
string

The account’s routing number.

subtype
string

The account’s subtype. Values may be checking or savings.

plaid_bank_account
object

Structured information about the Plaid account.

plaid_processor_token
string

A Check processor token retrieved from the Plaid API. Will be null when getting a list of bank accounts to avoid rate limiting.

metadata
object

Additional loosely structured information to associate with this bank account.