Find card usage group history

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

Use case

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

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

Sample API call

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

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

Learn more about the find card usage 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": [
        {
            "cardUsageGroupId": "C001681408107",
            "usageGroupName": "ALL_ALLOWED",
            "validityDateTimeRange": {
                "startTime": "2025-06-03T00:00:00Z",
                "endTime": null
            },
            "inserted": {
                "by": "Card User",
                "time": "2025-06-03T08:33:25.412Z"
            },
            "updated": {
                "by": "Card User",
                "time": "2025-06-03T08:33:25.412Z"
            }
        },
        {
            "cardUsageGroupId": "C001681408104",
            "usageGroupName": "PAYMENT_SERVICES",
            "validityDateTimeRange": {
                "startTime": "2025-05-01T00:00:00Z",
                "endTime": "2025-06-03T00:00:00Z"
            },
            "inserted": {
                "by": "John Officer",
                "time": "2025-04-01T13:02:17.997Z"
            },
            "updated": {
                "by": "Card User",
                "time": "2025-06-03T08:33:25.391Z"
            }
        },
        {
            "cardUsageGroupId": "C001681408103",
            "usageGroupName": "ALL_ALLOWED",
            "validityDateTimeRange": {
                "startTime": "2025-03-27T00:00:00Z",
                "endTime": "2025-05-01T00:00:00Z"
            },
            "inserted": {
                "by": "John Officer",
                "time": "2025-03-27T13:31:20.981Z"
            },
            "updated": {
                "by": "John Officer",
                "time": "2025-04-01T13:02:17.998Z"
            }
        },
        {
            "cardUsageGroupId": "C001681408105",
            "usageGroupName": "ALL_ALLOWED",
            "validityDateTimeRange": null,
            "inserted": {
                "by": "Card User",
                "time": "2025-06-03T08:32:13.529Z"
            },
            "updated": {
                "by": "Card User",
                "time": "2025-06-03T08:32:53.409Z"
            }
        },
        {
            "cardUsageGroupId": "C001681408106",
            "usageGroupName": "ALL_ALLOWED",
            "validityDateTimeRange": null,
            "inserted": {
                "by": "Card User",
                "time": "2025-06-03T08:32:53.463Z"
            },
            "updated": {
                "by": "Card User",
                "time": "2025-06-03T08:33:25.342Z"
            }
        }
    ]
}

Result

The result of the API call is a complete list of card usage group names associated with a specific card, along with their validity periods, indicating which groups were in effect at different points during the card’s lifecycle.