Financial Account

Create financial account

Changed on

Create a new financial account

post/v1/financial_accounts

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v1/financial_accounts
  • Auth
    API key in header Authorization

Headers

Idempotency-Keystring uuid

Idempotency key for the request

Request body

account_tokenstring uuid
nicknamestring required
type'OPERATING' required
is_for_benefit_ofboolean

Response

OK

tokenstring uuid required

Globally unique identifier for the account

createdstring date-time required
updatedstring date-time required
routing_numberstring nullable
account_numberstring nullable
blockchain_addressesobject nullable

Provisioned blockchain deposit addresses for this financial account, keyed by the full name of the blockchain network that each address belongs to (e.g. ETHEREUM)

nicknamestring nullable required
account_tokenstring uuid nullable required
status'OPEN' | 'CLOSED' | 'SUSPENDED' | 'PENDING' required

Status of the financial account

substatus'CHARGED_OFF_DELINQUENT' | 'CHARGED_OFF_FRAUD' | 'END_USER_REQUEST' | 'BANK_REQUEST' | 'DELINQUENT' | 'INTEREST_AND_FEES_PAUSED' required

Substatus for the financial account

user_defined_statusstring nullable required

User-defined status for the financial account

is_for_benefit_ofboolean required

Whether financial account is for the benefit of another entity

Example response

{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "blockchain_addresses": {
    "ETHEREUM": "0x5f2b9e8a1c4d7f0e3a6b9c2d5e8f1a4b7c0d3e6f"
  }
}

Changes

  • 50e7b2488836Revision changes
    • info

      added the optional property to the response with the status

  • bce16144ab19Revision changes
    • info

      removed the CHARGEBACK enum value from the / response property for the response status

    • info

      removed the INTERCHANGE enum value from the / response property for the response status