Update Spending Limits

Update the spending limits and merchant restrictions on a card. All fields are optional — only the fields you include will be updated.

Update spending limitsPUT/api/cards/:cardId/spend-limits

Request

Apply the update via PUT /api/cards/:cardId/spend-limits. All fields below are optional.

Path Parameters

cardIdstringRequired

The unique identifier of the card whose spending limits are being updated.

Body Parameters

single_transactionstring

Maximum amount allowed per individual transaction as a decimal string.

dailystring

Maximum total spending allowed per day as a decimal string.

weeklystring

Maximum total spending allowed per week as a decimal string.

monthlystring

Maximum total spending allowed per month as a decimal string.

allowed_categoriesarray

List of allowed MCC (Merchant Category Code) categories. Transactions at merchants outside these categories will be declined.

blocked_categoriesarray

List of blocked MCC categories. Transactions at merchants in these categories will be declined.

allowed_merchantsarray

Whitelist of specific merchant IDs. When set, only transactions at these merchants are allowed.

blocked_merchantsarray

Blacklist of specific merchant IDs. Transactions at these merchants will be declined.

Body Parameters

Response

card_idstring

Identifier of the card whose spending limits were updated.

operationstring

The operation type. Value is update_spending_limits for this endpoint.

spending_limitsobject

The full set of updated spending limits, including single_transaction, daily, weekly, monthly, allowed_categories, blocked_categories, allowed_merchants, and blocked_merchants.

updated_atstring

ISO 8601 timestamp of when the spending limits were last updated.

Response Body