Update account

account_token

• uuid
  required
  Globally unique identifier for account.

daily_spend_limit

• integer
  ≥ 0
  Defaults to 125000
  Amount (in cents) for the account's daily spend limit (e.g. 100000 would be a $1,000 limit).

lifetime_spend_limit

• integer
  ≥ 0
  Defaults to 0
  Amount (in cents) for the account's lifetime spend limit (e.g. 100000 would be a $1,000 limit).

monthly_spend_limit

• integer
  ≥ 0
  Defaults to 500000
  Amount (in cents) for the account's monthly spend limit (e.g. 100000 would be a $1,000 limit).

state

• string
  enum
  Account states:
  ACTIVE PAUSED CLOSED

substatus

• string | null
  enum Account state substatus values:
  • FRAUD_IDENTIFIED
  • SUSPICIOUS_ACTIVITY
  • RISK_VIOLATION
  • END_USER_REQUEST
  • ISSUER_REQUEST
  • NOT_ACTIVE
  • INTERNAL_REVIEW
  • OTHER

comment

• string
  Additional context or information related to the account.

verification_address

• object
  deprecated
  Address used during Address Verification Service (AVS) checks during transactions if enabled via Auth Rules.

account_holder

• object
  business_account_token
  • string
    required
    Only applicable for customers using the KYC-Exempt workflow to enroll authorized users of businesses.
    email
  • string
    required
    Email address. phone_number
  • string
    required
    Phone number of the individual. token
  • string
    required
    Globally unique identifier for the account holder. auth_rule_tokens
  • array of strings
    deprecated
    List of identifiers for the Auth Rule(s) that are applied on the account. cardholder_currency
  • string
    3-character alphabetic ISO 4217 code for the currency of the cardholder.

spend_limit

• object
  required
  Spend limit information for the user containing the daily, monthly, and lifetime spend limit of the account.
  • daily
    • integer
      required
      ≥ 0
      Daily spend limit (in cents).
  • lifetime
    • integer
      required
      ≥ 0
      Total spend limit over account lifetime (in cents).
  • monthly
    • integer
      required
      ≥ 0
      Monthly spend limit (in cents).

state

• string
  enum
  Account state:
  • ACTIVE
  • PAUSED
  • CLOSED

substatus

comment

• string
  Additional context or information related to the account.

token

• uuid
  required
  Globally unique identifier for the account.

verification_address

• object
  deprecated
  Address used during Address Verification Service (AVS) checks.

created

• date-time | null
  required
  Timestamp of when the account was created.

API Response Examples

PATCH Request

curl --request PATCH \
     --url https://sandbox.lithic.com/v1/accounts/account_token \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "daily_spend_limit": 1000,
  "lifetime_spend_limit": 0,
  "monthly_spend_limit": 500000
}
'  

Response Example

{
  "cardholder_currency": "USD",
  "spend_limit": {
    "daily": 1000,
    "lifetime": 100000,
    "monthly": 40000
  },
  "state": "ACTIVE",
  "token": "ecbd1d58-0299-48b3-84da-6ed7f5bf9ec1",
  "created": "2024-01-11T19:50:36Z",
  "verification_address": {
    "address1": "5 Broad Street",
    "address2": "",
    "city": "New York",
    "country": "USA",
    "postal_code": "10001",
    "state": "NY"
  }
}