Update Card Limits

POST

/api/v1/cardoperations/{cardId}/limits

Updates the card’s spending limits. Only the provided fields are updated, and two fields are required.

Optional Fields

Field	Type	Description	Constraints
`spendingLimits`	`array`	Period limits, at most one entry per interval (`DAILY`, `MONTHLY`, `YEARLY`)	Max items: 2 · Nullable
`spendingLimits[].interval`	`string`	The period the cap applies to	Enum: `DAILY`, `MONTHLY`, `YEARLY`
`spendingLimits[].amount`	`number`	The cap amount, in the card's currency	Min: 100 · Max: 1000000000

📤 Response Fields

Field	Type	Description
`id`	`string (uuid)`	Card identifier
`spendingLimits`	`array`	The card's current period limits
`updatedAt`	`string (date-time)`	Timestamp the limits were updated

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Limits updated.

Bodyapplication/json

🟠401

🟠404

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/cardoperations/6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f/limits' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data '{
    "spendingLimits": [
        {
            "interval": "DAILY",
            "amount": 2000
        },
        {
            "interval": "MONTHLY",
            "amount": 25000
        }
    ]
}'

Response Example

200 - Success

{
    "id": "6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f",
    "spendingLimits": [
        {
            "interval": "DAILY",
            "amount": 2000
        },
        {
            "interval": "MONTHLY",
            "amount": 25000
        }
    ],
    "updatedAt": "2026-01-15T11:30:00Z"
}

Modified at 2026-08-31 14:31:21

Change Card PIN

Freeze Card