Find card settings history

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

Use case

In this use case, we will retrieve the history of changes to the card's settings.

Use case data

API parameters with values

Search for the card settings history related to card C001664282649.

...cards/C001664282649/settings-history

Sample API call

To retrieve card settings history, use the following endpoint:

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

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

Sample request

The sample request body is as follows:

No request body.

curl -X 'GET' \
  'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282649/settings-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": [
    {
      "serviceCode": "00",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T14:29:27.187Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "00",
      "validityRange": {
        "endDate": null,
        "startDate": "2025-05-01"
      },
      "validityDateTimeRange": {
        "startTime": "2025-05-01T00:00:00Z",
        "endTime": null
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.05Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.05Z"
      }
    },
    {
      "serviceCode": "01",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T14:33:14.986Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "09",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.432Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "0A",
      "validityRange": {
        "endDate": null,
        "startDate": "2025-05-01"
      },
      "validityDateTimeRange": {
        "startTime": "2025-05-01T00:00:00Z",
        "endTime": null
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.058Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.058Z"
      }
    },
    {
      "serviceCode": "0C",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.427Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "0C",
      "validityRange": {
        "endDate": null,
        "startDate": "2025-05-01"
      },
      "validityDateTimeRange": {
        "startTime": "2025-05-01T00:00:00Z",
        "endTime": null
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.063Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.063Z"
      }
    },
    {
      "serviceCode": "0M",
      "validityRange": {
        "endDate": null,
        "startDate": "2025-05-01"
      },
      "validityDateTimeRange": {
        "startTime": "2025-05-01T00:00:00Z",
        "endTime": null
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.065Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.065Z"
      }
    },
    {
      "serviceCode": "10",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.434Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "20",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.436Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "20",
      "validityRange": {
        "endDate": null,
        "startDate": "2025-05-01"
      },
      "validityDateTimeRange": {
        "startTime": "2025-05-01T00:00:00Z",
        "endTime": null
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.07Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.07Z"
      }
    },
    {
      "serviceCode": "21",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.438Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "28",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.44Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "30",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.441Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    },
    {
      "serviceCode": "39",
      "validityRange": {
        "endDate": "2025-05-01",
        "startDate": "2025-03-27"
      },
      "validityDateTimeRange": {
        "startTime": "2025-03-27T00:00:00Z",
        "endTime": "2025-05-01T00:00:00Z"
      },
      "inserted": {
        "by": "John Officer",
        "time": "2025-03-27T13:31:18.444Z"
      },
      "updated": {
        "by": "John Officer",
        "time": "2025-04-01T13:02:18.034Z"
      }
    }
  ]
}

Result

The result of the API call is a complete list of service codes, along with their validity periods that were in effect at specific points during the card’s lifecycle.

PreviousFind card status history NextFind card limits history

Last updated 16 days ago

Was this helpful?