Set card limits

PUT

/baas/Cards/{id}/limits

Replaces the spending limits of a card. Each limit caps the total amount of payments, in the card currency, over its interval:

perAuthorization - a single payment;

per24Hours, per7Days, per30Days, perYear - a rolling period that ends at the time of the payment;

allTime - the lifetime of the card.

Early access - contact your account manager to enable card issuing for your platform.

Set at most one limit per interval. An empty limits list removes all limits of the card. Payments that exceed a limit are declined. Limits apply in addition to the balance of the card account.

The response contains the card with the new limits.

Errors: 400 Bad Request for a repeated interval or a non-positive amount; 404 Not Found if the card does not exist; 422 Unprocessable Content if the card is rejected or closed.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/json

Example

{
    "limits": [
        {
            "amount": 1000,
            "interval": "perAuthorization"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/baas/Cards//limits' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "limits": [
        {
            "amount": 1000,
            "interval": "perAuthorization"
        }
    ]
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "id": "0f8e2b6a-3c4d-4e5f-9a1b-7c2d3e4f5a6b",
    "externalId": "card-000123",
    "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
    "cardProductId": "06776ac8-abe1-475b-92ee-72405c7b0e60",
    "cardholderId": "29de7042-59a4-4af9-acc9-c12b40cdf661",
    "cardholderName": "ANNA SCHMIDT",
    "cardName": "Marketing subscriptions",
    "type": "virtual",
    "network": "visa",
    "currency": "USD",
    "state": "issuing",
    "stateReason": null,
    "last4": "4821",
    "expirationMonth": 9,
    "expirationYear": 2029,
    "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
    "limits": [
        {
            "amount": 1000,
            "interval": "perAuthorization"
        }
    ],
    "shipping": {
        "address": {
            "streetLine1": "string",
            "streetLine2": "string",
            "city": "string",
            "state": "string",
            "zip": "string",
            "country": "string"
        },
        "recipientName": "Anna Schmidt",
        "phoneNumber": "+4930123456789"
    },
    "createdAt": "2026-09-29T10:00:00Z"
}

🟠400Bad Request

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

Modified at 2026-09-29 14:00:50

Close card

Create encryption envelope