Set card spending limits

​

Set or change limits

PUT /api/cards/{cardId}/spend-limits

{
  "spending_limits": {
    "transaction_limit": 10000000,
    "daily_limit": 50000000,
    "weekly_limit": 200000000,
    "monthly_limit": 500000000,
    "yearly_limit": 6000000000,
    "all_time_limit": 10000000000
  }
}

{
  "success": true,
  "message": "Spending limits updated successfully",
  "timestamp": "2026-10-17T10:33:20.123378515Z"
}

​

Read limits back

"card_limits": {
  "transaction_limit": "10000000",
  "daily_limit": "50000000",
  "weekly_limit": "200000000",
  "monthly_limit": "500000000",
  "yearly_limit": "6000000000",
  "all_time_limit": "10000000000"
}

​

Rules to know

• Every value must be positive. 0 or a negative number fails with 400 VALIDATION_ERROR, for example spending limit daily_limit must be positive.
• A limit can’t be removed once set. Sending null or an empty spending_limits object is accepted, but changes nothing. To loosen a limit, set it to a higher value.
• Limits aren’t checked against each other. The API accepts a per-transaction limit above the daily limit, so validate the combination yourself before you send it.
• An empty body fails with 400 “spending_limits is required”, and an unknown card returns 404.