Set card limits

PUT

/baas/Cards/{id}/limits

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

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.

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 'https://my.test-1.account.finlego.com/api/child-brand-integration/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 11:12:37

Close card

Create encryption envelope