Skip to content

Create

Create financial account
post/v1/financial_accounts

Create a new financial account

Header Parameters
Idempotency-Keystring
optional
formatuuid
Body Parameters
nicknamestring
maxLength256
typeenum
Accepts one of the following: "OPERATING"
Hide ParametersShow Parameters
"OPERATING"
account_tokenstring
optional
formatuuid
is_for_benefit_ofboolean
optional
Returns
tokenstringaccount_tokenstringcreatedstringcredit_configurationobjectis_for_benefit_ofbooleannicknamestringstatusenumtypeenumupdatedstringaccount_numberstringrouting_numberstringsubstatusenumFinancialAccount
Request example Request
curl https://api.lithic.com/v1/financial_accounts \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "nickname": "nickname",
      "type": "OPERATING"
    }'
200 Example
{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "created": "2019-12-27T18:11:19.117Z",
  "credit_configuration": {
    "charged_off_reason": "DELINQUENT",
    "credit_limit": 0,
    "credit_product_token": "credit_product_token",
    "external_bank_account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "financial_account_state": "PENDING",
    "is_spend_blocked": true,
    "tier": "tier"
  },
  "is_for_benefit_of": true,
  "nickname": "nickname",
  "status": "OPEN",
  "type": "ISSUING",
  "updated": "2019-12-27T18:11:19.117Z",
  "account_number": "account_number",
  "routing_number": "routing_number",
  "substatus": "CHARGED_OFF_DELINQUENT"
}