v1

latestOpenAPI 3.1.0UNLICENSED2026-07-2613101.1 MB

Spending limits

Update spending limit for a card

Updates the spending limit for a given card.

put/cards/{cardId}/spending-limits/{limitId}

Path parameters

cardIdstring uuid required

The ID of the card to work with.

Example:e9293471-5eb3-4dbc-916c-dbaf9e2deefd

limitIdstring uuid required

The ID of the limit to work with.

Query parameters

accountIdstring required

The ID of the account to work with.

Example:F50091

budgetIdstring uuid required

The ID of the budget to work with.

Example:775596ae-2624-40af-a9dc-9756110a4a03

personIdstring uuid

The ID of the person to work with.

Example:775596ae-2624-40af-a9dc-9756110a4a04

Request body

Example request

{
  "amount": 100.5,
  "usageLimit": 15
}

Response

idstring uuid

The ID of the limit to work with.

amountnumber required

amount of limit to be set

currencyCodestring

activeboolean

Indicates whether the limit is active on Marqeta.

usageLimitinteger

Number of transactions allowed in a given time window. -1 means the limit is disabled. 0 means no transactions can be made.

limitTurnedOffboolean

Defines if the limit was turned off by the user

limitWindow'DAY' | 'WEEK' | 'MONTH' | 'LIFETIME' required

Defines the time period to which the limit apply

Example response

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "amount": 100.5,
  "currencyCode": "GBP",
  "active": true,
  "usageLimit": 15,
  "limitTurnedOff": true,
  "limitWindow": "DAY",
  "available": {
    "uses": 0,
    "amount": 100.5,
    "daysRemaining": 1
  }
}