financial_account_token

uuid

required

200 OK

object

• token

  • uuid
  • required
  • Globally unique identifier for the account

• created

  • date-time
  • required

• updated

  • date-time
  • required

• type

  • Instance Financial Account Type | Account Financial Account Type
  • required

• routing_number

  • string | null

• account_number

  • string | null

• nickname

  • string | null
  • required

• account_token

  • uuid | null
  • required

• status

  • string
  • enum
  • required
  • Status of the financial account
    • OPEN
    • CLOSED
    • SUSPENDED
    • PENDING

• substatus

  • null
  • Financial Account Substatus
  • required

• user_defined_status

  • string | null
  • required
  • User-defined status for the financial account

• is_for_benefit_of

  • boolean
  • required
  • Whether financial account is for the benefit of another entity

• credit_configuration

  • object | null
  • required
    • credit_limit
      • integer | null
      • required
    • external_bank_account_token
      • uuid | null
      • required
    • credit_product_token
      • string | null
      • required
      • Globally unique identifier for the credit product
    • tier
      • string | null
      • required
      • Tier assigned to the financial account
    • auto_collection_configuration
      • null
      • Auto Collection Configuration Response
      • required

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 | 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 |

404 The specified resource was not found.

422 Unprocessable entity.

429 Client has exceeded the number of allowed requests in a given time period.

| | | | | --- | --- | | 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 |

Updated 3 months ago

Shell

curl --request GET \
     --url https://sandbox.lithic.com/v1/financial_accounts/financial_account_token \
     --header 'accept: application/json'

Response

{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "created": "2026-07-18T00:25:32.659Z",
  "updated": "2026-07-18T00:25:32.659Z",
  "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
    }
  }
}

Updated 3 months ago