Create external bank account

post

https://sandbox.lithic.com/v1/external_bank_accounts

Creates an external bank account within a program or Lithic account.

Body Params

verification_method

string

enum

required

Verification Method

Allowed:

owner_type

string

enum

required

Owner Type

Allowed:

owner

string

required

length between 1 and 100

Legal Name of the business or individual who owns the external account. This will appear in statements

account_token

uuid

Indicates which Lithic account the external account is associated with. For external accounts that are associated with the program, account_token field returned will be null

company_id

string

length between 1 and 10

Optional field that helps identify bank accounts in receipts

doing_business_as

string

length between 1 and 40

Doing Business As

dob

date

Date of Birth of the Individual that owns the external bank account

user_defined_id

string

length between 1 and 256

User Defined ID

type

string

enum

required

Account Type

Allowed:

routing_number

string

required

length between 9 and 9

Routing Number

account_number

string

required

length between 1 and 17

Account Number

name

string

length between 1 and 50

The nickname for this External Bank Account

country

string

required

length between 3 and 3

The country that the bank account is located in using ISO 3166-1. We will only accept USA bank accounts e.g., USA

currency

string

required

length between 3 and 3

currency of the external account 3-character alphabetic ISO 4217 code

verification_enforcement

boolean

Defaults to true

address

object

Address

financial_account_token

uuid

required

The financial account token of the operating account to fund the micro deposits

Responses


User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: [api-key]	The Authorization header is not formatted properly
Insufficient privileges. Issuing API key required	Write access requires an Issuing API key. Reach out at lithic.com/contact
Insufficient privileges to create virtual cards.	Creating virtual cards requires an additional privilege


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

201Created

400A parameter in the query given in the request does not match the valid queries for the endpoint.

409Conflict