Change card limit group

Here, you will learn how to change the card limit group in Tuum.

Use case

In this example, we will demonstrate how to update the card limit group using the following data.

Use case data	API parameters with values
The card limit group will be changed for card C001664282649.	...cards/C001664282649/limit-groups/change
New limit group information. In this example, the limit group PAYMENT_3000 will become effective starting from 01.05.2025. Note: If the validityStart date is the current date, the change takes effect immediately.	"limitGroupName": "PAYMENT_3000", "validityStart": "2025-05-01"

Sample API call

To change the card limit group, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v1/cards/{cardId}/limit-groups/change

Learn more about the change card limit group endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

JSON

{
  "limitGroupName": "PAYMENT_3000",
  "validityStart": "2025-05-01"
}

cURL

curl -X 'POST' \
  'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282649/limit-groups/change' \
  -H 'accept: */*' \
  -H 'x-tenant-code: MB' \
  -H 'Accept-Language: en' \
  -H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiSm9obiBPZmZpY2VyIiwiZW1wbG95ZWVJZCI6IjEiLCJ0ZW5hbnRDb2RlIjoiTUIiLCJleHBpcnlEVGltZSI6IjIwMjUtMDQtMDJUMDg6NTY6NTkiLCJleHAiOjE3NDM1ODQyMTksInJvbGVzIjpbIkFETUlOIiwiUE9TVElOR1NfVEVBTSIsIlNZU1RFTSJdfQ.hIo0b__2GdF185L5hBOje3RZZLILtTAIB0kFWqAA6Q8' \
  -H 'Content-Type: application/json' \
  -d '{
  "limitGroupName": "PAYMENT_3000",
  "validityStart": "2025-05-01"
}'

Sample response

Below you will find the response to the API request:

Response

{
  "errors": null,
  "validationErrors": null,
  "data": null
}

Result

Starting from 2025-05-01 at 00:00:00, the PAYMENT_3000 limit group will apply to card C001664282649. As a result of this change, the card limits will also be updated: the current limits will expire on 2025-05-01 at 00:00:00, and the new limits will take effect from the same date.