Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-261190449.2 KB
Cards

Update Card Limit

Change the card limit for a given virtual or physical card, as long as the card is not terminated. This is unrelated to the renew frequency of the card. Meaning you can update the limit of a card with a TOTAL renew frequency (equals no limit renewal) as well as a MONTHLY renew frequency etc.

Additional limits: Use the additionalLimits field to create, update, or remove additional limits on the card in the same request.

  • Entries with an id → update the matching existing additional limit.
  • Entries without an id → create a new additional limit.
  • Existing additional limits omitted from the array → soft-delete (removed).
  • Passing null or omitting additionalLimits → leave existing additional limits unchanged.
  • Passing an empty array [] → remove all additional limits from the card.

Response: This endpoint returns 204 No Content. To read the updated limit state use GET /api/cards/{cardId} or subscribe to the CARD_LIMITS_CHANGED callback.

put/cards/limits/{cardId}

Path parameters

cardIdstring uuid required

The ID of the card to update the limit for.

Request body

limitRenewFrequency'DAILY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'TOTAL'

The frequency of the card limit renewal.

  • DAILY - The card limit is renewed every day
  • WEEKLY - The card limit is renewed every week
  • MONTHLY - The card limit is renewed every calendar month, this is the default setting.
  • QUARTERLY - The card limit is renewed every calendar quarter.
  • ANNUAL - The card limit is renewed every year.
  • TOTAL - The card limit is never going to be renewed. After the limit is spent the card cannot be used anymore.
maxTransactionCountnumber

Optional field to describe the maximum number of transactions within the range of 1..999999999 that can be performed with this card. If not provided, the card can be used for an unlimited number of transactions until the card expires.

Response

Ok