Sign in

v1

latestOpenAPI 3.1.0UNLICENSED2026-07-2613101.1 MB
Spending limits

Create spending limit for a card

Creates a spending limit for a given card. A spending limit defines the maximum amount that can be spent during a chosen time period. For example, £10 a day.

post/cards/{cardId}/spending-limits

Path parameters

cardIdstring uuid required

The ID of the card to work with.

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

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

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 request

{
  "amount": 100.5,
  "currencyCode": "GBP",
  "active": true,
  "usageLimit": 15,
  "limitTurnedOff": true,
  "limitWindow": "DAY"
}

Response

OK

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
  }
}