logo

Bank Account

Create/manage bank accounts for your businesses. These accounts are used for paying out earnings for usage of various products, for example card processing.

Create a Bank Account

Create a bank account

Request
header Parameters
Authorization
required
string

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Example: Bearer {access_token}
Request Body schema: application/json
required
account_owner_name
required
string

name of the account owner

account_type
required
string

type of account

Value: "checking savings"
account_number
required
string

the account number

routing_number
required
string

routing number

business_id
required
string <uuid>

business id which owns the account

bank_name
string

bank name

nickname
string

nickname for the bank account

metadata
object

any useful information you'd like to store alongside this bank account

Responses
201

Bank Account was created successfully

post/entities/bank_accounts
Request samples
application/json
{
  • "account_owner_name": "Napheesa Collier",
  • "account_type": "checking",
  • "account_number": "000123456789",
  • "routing_number": "110000000",
  • "business_id": "biz_abc123",
  • "bank_name": "Wells Fargo",
  • "nickname": "Phee's Money",
  • "metadata": {
    }
}
Response samples
application/json
{
  • "id": 1,
  • "type": "bank_account",
  • "data": {
    },
  • "page_info": "string"
}

List Bank Accounts

List the bank accounts you have created for a business. This endpoint supports pagination.

Request
query Parameters
business_id
string

filter bank accounts which are associated with a business

Example: business_id=biz_xyz
header Parameters
Authorization
required
string

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Example: Bearer {access_token}
Responses
200

Successfully list bank accounts

get/entities/bank_accounts
Request samples 
Response samples 
application/json
{
  • "id": 1,
  • "type": "array",
  • "data": [
    ],
  • "page_info": {
    }
}
Get a Bank Account
Get details about a bank account


Request 
path Parameters
id
required
string <uuid> 
 
header Parameters
Authorization
required
string
the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)


 
 Example:  Bearer {access_token}
Responses 
200
Get Bank Account


get/entities/bank_accounts/{id}
Request samples 
Response samples 
application/json
{
  • "id": 1,
  • "type": "bank_account",
  • "data": {
    },
  • "page_info": "string"
}
➔ Next to JustiFi Web Components