Update

Update account

patch/v1/accounts/{account_token}

Update account configuration such as state or spend limits. Can only be run on accounts that are part of the program managed by this API key. Accounts that are in the PAUSED state will not be able to transact or create new cards.

Path Parameters

account_tokenstring

formatuuid

Body Parameters

daily_spend_limitnumber

optional

Amount (in cents) for the account's daily spend limit (e.g. 100000 would be a $1,000 limit). By default the daily spend limit is set to $1,250.

minimum0

lifetime_spend_limitnumber

optional

Amount (in cents) for the account's lifetime spend limit (e.g. 100000 would be a $1,000 limit). Once this limit is reached, no transactions will be accepted on any card created for this account until the limit is updated. Note that a spend limit of 0 is effectively no limit, and should only be used to reset or remove a prior limit. Only a limit of 1 or above will result in declined transactions due to checks against the account limit. This behavior differs from the daily spend limit and the monthly spend limit.

minimum0

monthly_spend_limitnumber

optional

Amount (in cents) for the account's monthly spend limit (e.g. 100000 would be a $1,000 limit). By default the monthly spend limit is set to $5,000.

minimum0

stateenum

optional

Accepts one of the following: "ACTIVE", "PAUSED", "CLOSED"

Account states.

Hide ParametersShow Parameters

"ACTIVE"

"PAUSED"

"CLOSED"

verification_addressobject

optional

deprecated

Address used during Address Verification Service (AVS) checks during transactions if enabled via Auth Rules. This field is deprecated as AVS checks are no longer supported by Auth Rules. The field will be removed from the schema in a future release.

Hide ParametersShow Parameters

address1string

optional

address2string

optional

citystring

optional

countrystring

optional

postal_codestring

optional

statestring

optional

Returns

tokenstringcreatedstringspend_limitobjectstateenumaccount_holderobjectauth_rule_tokensarray of stringcardholder_currencystringverification_addressobjectAccount

Request example Request

curl https://api.lithic.com/v1/accounts/$ACCOUNT_TOKEN \
    -X PATCH \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{}'

200 Example

{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "created": "2019-12-27T18:11:19.117Z",
  "spend_limit": {
    "daily": 10000,
    "lifetime": 100000,
    "monthly": 40000
  },
  "state": "ACTIVE",
  "account_holder": {
    "token": "95e5f1b7-cfd5-4520-aa3c-2451bab8608d",
    "business_account_token": "e87db14a-4abf-4901-adad-5d5c9f46aff2",
    "email": "jack@lithic.com",
    "phone_number": "+12124007676"
  },
  "auth_rule_tokens": [
    "string"
  ],
  "cardholder_currency": "USD",
  "verification_address": {
    "address1": "124 Old Forest Way",
    "city": "Seattle",
    "country": "USA",
    "postal_code": "98109",
    "state": "WA",
    "address2": "Apt 21"
  }
}