Verify a company bank account

PUT {{baseUrl}}/v1/companies/:company_id/bank_accounts/:bank_account_uuid/verify

Verify a company bank account by confirming the two micro-deposits sent to the bank account. Note that the order of the two deposits specified in request parameters does not matter. There's a maximum of 5 verification attempts, after which we will automatically initiate a new set of micro-deposits and require the bank account to be verified with the new micro-deposits.

Bank account verification in demo

We provide the endpoint POST '/v1/companies/{company_id}/bank_accounts/{bank_account_uuid}/send_test_deposits' to facilitate bank account verification in the demo environment. This endpoint simulates the micro-deposits transfer and returns them in the response. You can call this endpoint as many times as you wish to retrieve the values of the two micro deposits.

  POST '/v1/companies/89771af8-b964-472e-8064-554dfbcb56d9/bank_accounts/ade55e57-4800-4059-9ecd-fa29cfeb6dd2/send_test_deposits'

  {
    "deposit_1": 0.02,
    "deposit_2": 0.42
  }

scope: company_bank_accounts:write

Request Body

{"deposit_1"=>"<number>", "deposit_2"=>"<number>"}

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;uuid&quot;:&quot;1263eae5-4411-48d9-bd6d-18ed93082e65&quot;,&quot;company_uuid&quot;:&quot;e2c4c0ce-2986-48b9-86cf-ec27f6ed9a36&quot;,&quot;account_type&quot;:&quot;Checking&quot;,&quot;routing_number&quot;:&quot;851070439&quot;,&quot;hidden_account_number&quot;:&quot;XXXX4087&quot;,&quot;verification_status&quot;:&quot;verified&quot;,&quot;verification_type&quot;:&quot;bank_deposits&quot;,&quot;name&quot;:&quot;Employer Funding Account&quot;}