v1

latestOpenAPI 3.1.0UNLICENSED2026-07-2613101.1 MB
Transaction limits

Create transaction limit for a card

Creates a transaction limit for a given card. A transaction limit defines the maximum amount that can be spent in a single transaction.

post/cards/{cardId}/transaction-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.

limitTurnedOffboolean

Defines if the limit was turned off by the user

limitWindow'TRANSACTION' required

Defines the time period to which the limit apply

Example request

{
  "amount": 100.5,
  "currencyCode": "GBP",
  "active": true,
  "limitTurnedOff": true,
  "limitWindow": "TRANSACTION"
}

Response

Created

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.

limitTurnedOffboolean

Defines if the limit was turned off by the user

limitWindow'TRANSACTION' 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,
  "limitTurnedOff": true,
  "limitWindow": "TRANSACTION"
}