API Documentation

Account Token

• uuid: The unique identifier for the account. (required)
• nickname: A string (length ≤ 256) used to identify the account. (required)
• type: Specifies the account type. (required)
  • Enum: OPERATING
• is_for_benefit_of: A boolean indicating if the account is for the benefit of another entity. (required)

Idempotency-Key

• uuid: Idempotency key for the request.

Response: 200 OK

• object: Response object containing account details.
  • token: (uuid) Globally unique identifier for the account. (required)
  • created: (date-time) Date when the account was created. (required)
  • updated: (date-time) Date when the account was last updated. (required)
  • type: Type of financial account. (required)
  • routing_number: (string | null)
  • account_number: (string | null)
  • nickname: (string | null) (required)
  • account_token: (uuid | null) (required)
  • status: (string) Current status of the financial account. (required)
    • Enum: OPEN, CLOSED, SUSPENDED, PENDING
  • substatus: (null) Financial Account Substatus (required)
  • user_defined_status: (string | null) (required)
  • is_for_benefit_of: (boolean) (required)
  • credit_configuration: (object | null) (required)
    • credit_limit: (integer | null) (required)
    • external_bank_account_token: (uuid | null) (required)
    • credit_product_token: (string | null) (required)
    • tier: (string | null) (required)
    • auto_collection_configuration: (null) Auto Collection Configuration Response (required)

Error Responses

• 400: A parameter in the query given in the request does not match the valid queries for the endpoint.
• 401: User has not been authenticated.
• 404: The specified resource was not found.
• 429: Client has exceeded the number of allowed requests in a given time period.

Example Request

curl --request POST \
     --url https://sandbox.lithic.com/v1/financial_accounts \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data ' {
  "account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "nickname": "string",
  "type": "OPERATING",
  "is_for_benefit_of": true
}
' 

Example Response

{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "created": "2026-07-18T00:25:32.604Z",
  "updated": "2026-07-18T00:25:32.604Z",
  "type": "ISSUING",
  "routing_number": "string",
  "account_number": "string",
  "nickname": "string",
  "account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "OPEN",
  "substatus": "CHARGED_OFF_DELINQUENT",
  "user_defined_status": "string",
  "is_for_benefit_of": true,
  "credit_configuration": {
    "credit_limit": 0,
    "external_bank_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "credit_product_token": "string",
    "tier": "string",
    "auto_collection_configuration": {
      "auto_collection_enabled": true
    }
  }
}