Get all company bank accounts

get https://api.gusto-demo.com/v1/companies/{company_id}/bank_accounts

Returns company bank accounts. Currently, we only support a single default bank account per company.

scope: company_bank_accounts:read

Responses

Response body

array of objects

object

uuid

string

required

UUID of the bank account

company_uuid

string

UUID of the company

account_type

string

Bank account type

Checking Savings

routing_number

string

The bank account's routing number

hidden_account_number

string

Masked bank account number

verification_status

string

The verification status of the bank account.

'awaiting_deposits' means the bank account is just created and money is being transferred.
'ready_for_verification' means the micro-deposits are completed and the verification process can begin by using the verify endpoint.
'verified' means the bank account is verified.

awaiting_deposits ready_for_verification verified

verification_type

string

The verification type of the bank account.

'bank_deposits' means the bank account is connected by entering routing and accounting numbers and verifying through micro-deposits.
'plaid' means the bank account is connected through Plaid.

bank_deposits plaid plaid_external

plaid_status

string | null

The Plaid connection status of the bank account. Only applies when verification type is Plaid.

connected disconnected

last_cached_balance

string | null

The last fetch balance for the bank account. Please be aware that this amount does not reflect the most up-to-date balance and only applies when the verification type is Plaid.

balance_fetched_date

string | null

The balance fetch date associated with the last_cached_balance. Only applies when verification type is Plaid.

name

string

Name of bank account

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.gusto-demo.com/v1/companies/company_id/bank_accounts \
3
     --header 'X-Gusto-API-Version: 2024-04-01' \
4
     --header 'accept: application/json'


xxxxxxxxxx
12
 
1
[
2
  {
3
    "uuid": "1263eae5-4411-48d9-bd6d-18ed93082e65",
4
    "company_uuid": "e2c4c0ce-2986-48b9-86cf-ec27f6ed9a36",
5
    "account_type": "Checking",
6
    "routing_number": "851070439",
7
    "hidden_account_number": "XXXX4087",
8
    "verification_status": "verified",
9
    "verification_type": "bank_deposits",
10
    "name": "Employer Funding Account"
11
  }
12
]

200Example response