Manage transaction limits

A transaction limit defines the maximum amount that can be spent on a card in a single transaction. A card can have both a spending limit and a transaction limit. Learn more about spending limits.

info

The endpoints described in this guide are currently in beta mode.

Retrieve a transaction limit

Get/v2/cards/{cardId}/transaction-limits

Request

Use this request to retrieve a transaction limit for a given card, based on its id.

Sample requestRequest structure

Copy

Copied

curl -i -X GET \
  'https://api.equalsmoney.com/v2/cards/e9293471-5eb3-4dbc-916c-dbaf9e2deefd/transaction-limits?accountId=F12345&budgetId=775596ae-2624-40af-a9dc-9756110a4a03' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

Copy

Copied

curl -i -X GET \
  'https://api.equalsmoney.com/v2/cards/{cardId}/transaction-limits?accountId={accountId}&budgetId={budgetId}' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

Path parameters

Parameter	Description
`cardId` string (uuid) required	The ID of the card that you want to retrieve the transaction limit for. Allowable values: An existing `cardId` (<= 36 characters)

Query parameters

Parameter	Description
`accountId` string required	The ID of the account that the card is associated with. Allowable values: An existing `accountId`
`budgetId` string (uuid) required	The ID of the budget that the card is associated with. Allowable values: An existing `budgetId` (<= 36 characters)
`personId` string (uuid)	The ID of the person that the card belongs to. Allowable values: An existing `personId` (<= 36 characters)

Response

If your request is successful, you'll receive a 200 response.

Sample responseResponse structure

Copy

Copied

{
  "id": "775596ae-2624-40af-a9dc-9756110a4a03",
  "amount": 100.5,
  "active": false,
  "limitTurnedOff": true,
  "limitWindow": "TRANSACTION"
}

Copy

Copied

{
  "id": "string",
  "amount": number,
  "active": boolean,
  "limitTurnedOff": boolean,
  "limitWindow": "string"
}

For more detailed information about this request and its response, see the API reference.

Create a transaction limit

Post/v2/cards/{cardId}/transaction-limits

Request

Use this request to create a transaction limit for a given card.

Sample requestRequest structure

Copy

Copied

curl -i -X POST \
  'https://api.equalsmoney.com/v2/cards/e9293471-5eb3-4dbc-916c-dbaf9e2deefd/transaction-limits?accountId=F12345&budgetId=775596ae-2624-40af-a9dc-9756110a4a03' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "775596ae-2624-40af-a9dc-9756110a4a03",
    "amount": 100.5,
    "active": false,
    "limitTurnedOff": true,
    "limitWindow": "TRANSACTION"
  }'

Copy

Copied

curl -i -X POST \
  'https://api.equalsmoney.com/v2/cards/{cardId}/transaction-limits?accountId={accountId}&budgetId={budgetId}' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '
  {
    "id": "string",
    "amount": number,
    "active": boolean,
    "limitTurnedOff": boolean,
    "limitWindow": "string"
  }'

Path parameters

Parameter	Description
`cardId` string (uuid) required	The ID of the card that you want to create a transaction limit for. Allowable values: An existing `cardId` (<= 36 characters)

Query parameters

Parameter	Description
`accountId` string required	The ID of the account that the card is associated with. Allowable values: An existing `accountId`
`budgetId` string (uuid) required	The ID of the budget that the card is associated with. Allowable values: An existing `budgetId` (<= 36 characters)
`personId` string (uuid)	The ID of the person that the card belongs to. Allowable values: An existing `personId` (<= 36 characters)

Request body schema

Parameter	Description
`id` string (uuid)	The ID of the transaction limit that you want to create. Allowable values: A valid string
`amount` number required	The amount that you want to set as the transaction limit. Allowable values: A valid number
`active` boolean	Whether or not you want the transaction limit to be active on Marqeta. Allowable values: `true`, `false`
`limitTurnedOff` boolean	Whether or not you want the transaction limit to be turned off. Allowable values: `true`, `false`
`limitWindow` string required	The time period for which the transaction limit applies. Always set this to `TRANSACTION`. Allowable values: `TRANSACTION`

Response

If your request is successful, you'll receive a 200 response.

Sample responseResponse structure

Copy

Copied

{
  "id": "775596ae-2624-40af-a9dc-9756110a4a03",
  "amount": 100.5,
  "active": false,
  "limitTurnedOff": true,
  "limitWindow": "TRANSACTION"
}

Copy

Copied

{
  "id": "string",
  "amount": number,
  "active": boolean,
  "limitTurnedOff": boolean,
  "limitWindow": "string"
}

For more detailed information about this request and its response, see the API reference.

Update a transaction limit

Put/v2/cards/{cardId}/transaction-limits/{limitId}

Request

Use this request to update the transaction limit for a given card.

Sample requestRequest structure

Copy

Copied

curl -i -X PUT \
  'https://api.equalsmoney.com/v2/cards/e9293471-5eb3-4dbc-916c-dbaf9e2deefd/transaction-limits/0684fc07-4abc-46de-b664-da45ef3c4072?accountId=F12345&budgetId=775596ae-2624-40af-a9dc-9756110a4a03' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "775596ae-2624-40af-a9dc-9756110a4a03",
    "amount": 100.5,
    "active": false,
    "limitTurnedOff": true,
    "limitWindow": "TRANSACTION"
  }'

Copy

Copied

curl -i -X PUT \
  'https://api.equalsmoney.com/v2/cards/{cardId}/transaction-limits/{limitId}?accountId={accountId}&budgetId={budgetId}' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "string",
    "amount": number,
    "active": boolean,
    "limitTurnedOff": boolean,
    "limitWindow": "string"
  }`

Path parameters

Parameter	Description
`cardId` string (uuid) required	The ID of the card that the transaction limit applies to. Allowable values: An existing `cardId` (<= 36 characters)
`limitId` string (uuid) required	The ID of the transaction limit that you want to update. Allowable values: An existing `limitId` (<= 36 characters)

Query parameters

Parameter	Description
`accountId` string required	The ID of the account that the card is associated with. Allowable values: An existing `accountId`
`budgetId` string (uuid) required	The ID of the budget that the card is associated with. Allowable values: An existing `budgetId` (<= 36 characters)
`personId` string (uuid)	The ID of the person that the card belongs to. Allowable values: An existing `personId` (<= 36 characters)

Request body schema

Parameter	Description
`id` string (uuid)	The new ID of the transaction limit. Allowable values: A valid string
`amount` number required	The amount that you want to set as the transaction limit. Allowable values: A valid number
`active` boolean	Whether or not you want the transaction limit to be active on Marqeta. Allowable values: `true`, `false`
`limitTurnedOff` boolean	Whether or not you want the transaction limit to be turned off. Allowable values: `true`, `false`
`limitWindow` string required	The time period for which the transaction limit applies. Always set this to `TRANSACTION`. Allowable values: `TRANSACTION`

Response

If your request is successful, you'll receive a 200 response.

Sample responseResponse structure

Copy

Copied

{
  "id": "775596ae-2624-40af-a9dc-9756110a4a03",
  "amount": 100.5,
  "active": false,
  "limitTurnedOff": true,
  "limitWindow": "TRANSACTION"
}

Copy

Copied

{
  "id": "string",
  "amount": number,
  "active": boolean,
  "limitTurnedOff": boolean,
  "limitWindow": "string"
}

For more detailed information about this request and its response, see the API reference.