Find card limits history

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

Use case

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

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

Sample API call

To retrieve the card limits history, use the following endpoint:

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

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

Sample request

The sample request body is as follows:

Body

No request body.

cURL

curl -X 'GET' \
  'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282649/limits-history' \
  -H 'accept: */*' \
  -H 'x-tenant-code: MB' \
  -H 'Accept-Language: en' \
  -H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiSm9obiBPZmZpY2VyIiwiZW1wbG95ZWVJZCI6IjEiLCJ0ZW5hbnRDb2RlIjoiTUIiLCJleHBpcnlEVGltZSI6IjIwMjUtMDQtMDJUMDg6MDE6NTQiLCJleHAiOjE3NDM1ODA5MTQsInJvbGVzIjpbIkFETUlOIiwiUE9TVElOR1NfVEVBTSIsIlNZU1RFTSJdfQ.UbVbQx2Q4anDZxWxIQ9919A2Ka15uneqhM5ZmIoOAYw'

Sample response

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

Response

{
  "errors": null,
  "validationErrors": null,
  "data": [
    {
      "limitCode": "CASH",
      "transactionLimit": {
        "amount": 500,
        "currencyCode": "EUR"
      },
      "dailyLimit": {
        "amount": 1000,
        "currencyCode": "EUR"
      },
      "monthlyLimit": {
        "amount": 5000,
        "currencyCode": "EUR"
      },
      "validityRange": {
        "startDate": "2025-03-27",
        "endDate": null
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": null
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.457Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.457Z"
      }
    },
    {
      "limitCode": "ECOMMERCE",
      "transactionLimit": {
        "amount": 1000,
        "currencyCode": "EUR"
      },
      "dailyLimit": {
        "amount": 3000,
        "currencyCode": "EUR"
      },
      "monthlyLimit": {
        "amount": 5000,
        "currencyCode": "EUR"
      },
      "validityRange": {
        "startDate": "2025-03-27",
        "endDate": null
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": null
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.458Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.458Z"
      }
    },
    {
      "limitCode": "PURCHASE",
      "transactionLimit": {
        "amount": 1500,
        "currencyCode": "EUR"
      },
      "dailyLimit": {
        "amount": 3000,
        "currencyCode": "EUR"
      },
      "monthlyLimit": {
        "amount": 7000,
        "currencyCode": "EUR"
      },
      "validityRange": {
        "startDate": "2025-03-27",
        "endDate": null
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": null
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.448Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.448Z"
      }
    }
  ]
}

Result

The result of the API call is a complete list of limits (transaction, daily, and monthly) associated with a specific limit type, along with their validity periods that were in effect at specific points during the card's lifecycle.