Update Spending Limits

Update the spending limits on a card. Provide a spending_limits object containing the limit fields you want to change. Limit values are integers in micro-units, where 1 whole unit = 1,000,000 (e.g. $50 = 50000000).

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

Request

Apply the update via PUT /api/cards/:cardId/spend-limits. The spending_limits object is required; the individual limit fields within it are optional — include only the limits you want to change.

Path Parameters

cardIdstringRequired

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

Body Parameters

spending_limitsobjectRequired

Wrapper object containing the limit fields to update. All limit values are integers in micro-units (1 unit = 1,000,000).

spending_limits.transaction_limitinteger

Maximum amount allowed per individual transaction, in micro-units (1 whole unit = 1,000,000).

spending_limits.daily_limitinteger

Maximum total spending allowed per day, in micro-units (1 whole unit = 1,000,000).

spending_limits.weekly_limitinteger

Maximum total spending allowed per week, in micro-units (1 whole unit = 1,000,000).

spending_limits.monthly_limitinteger

Maximum total spending allowed per month, in micro-units (1 whole unit = 1,000,000).

spending_limits.yearly_limitinteger

Maximum total spending allowed per year, in micro-units (1 whole unit = 1,000,000).

spending_limits.all_time_limitinteger

Maximum cumulative spending allowed over the lifetime of the card, in micro-units (1 whole unit = 1,000,000).

Amounts are in micro-units

All limit values are integers in micro-units: 1 unit = 1,000,000. For example, a daily_limit of 50000000 is 50 units (e.g. $50.00) and transaction_limit of 10000000 is 10 units.

Body Parameters

Response

successboolean

Indicates whether the request succeeded.

messagestring

Human-readable result message, e.g. "Spending limits updated successfully".

dataobject

Result payload, echoing the success flag and message.

timestampstring

ISO 8601 timestamp of when the response was generated.

Response Body