Find card limit group history

In this section, you will learn how to find card limit group history in Tuum.

Use case

In this example, we will demonstrate how to find the history of card limit group.

Use case data	API parameters with values
Search for the card limit group history related to card C001664282649.	...cards/C001664282649/limit-group-history

Sample API call

To retrieve the card limit group history, use the following endpoint:

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

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

Sample request

The sample request body is as follows:

Body

No request body.

cURL

Sample response

Below is an example of the response body for the API call above.

Response

{
    "errors": null,
    "validationErrors": null,
    "data": [
        {
            "cardLimitGroupId": "C001681408105",
            "limitGroupName": "PAYMENT_3000",
            "validityDateTimeRange": {
                "startTime": "2025-05-01T00:00:00Z",
                "endTime": null
            },
            "inserted": {
                "by": "John Officer",
                "time": "2025-04-02T08:38:47.853145Z"
            },
            "updated": {
                "by": "test kasutaja",
                "time": "2025-06-02T09:10:40.084Z"
            }
        },
        {
            "cardLimitGroupId": "C001681408104",
            "limitGroupName": "HIGH_LIMIT_GROUP",
            "validityDateTimeRange": {
                "startTime": "2025-03-27T00:00:00Z",
                "endTime": "2025-05-01T00:00:00Z"
            },
            "inserted": {
                "by": "John Officer",
                "time": "2025-03-27T13:31:20.851656Z"
            },
            "updated": {
                "by": "liquibase",
                "time": "2025-04-22T13:41:43.392364Z"
            }
        }
    ]
}

Result

The result of the API call is a complete list of card limit group names associated with a specific card, along with their validity periods, showing which groups were active at various points during the card’s lifecycle.