Find card price list history

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

Use case

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

Use case data	API parameters with values
Search for the card price list history related to card C001664282649.	...cards/C001664282649/pricelist-history

Sample API call

To retrieve the card price list history, use the following endpoint:

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

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

Sample request

The sample request body is as follows:

Body

No request body.

cURL

curl -L 'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282649/pricelist-history' \
-H 'accept: */*' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoidGVzdCBrYXN1dGFqYSIsImVtcGxveWVlSWQiOiJJRC0xMTAwIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA4LTI3VDA5OjU3OjMyIiwiZXhwIjoxNzU2Mjg4NjUyLCJyb2xlcyI6WyJBRE1JTiIsIlNZU1RFTSJdfQ.rM1fj0NW4z1niOAEhdLwDAEJl8JQ1CQfFTRhkrSoIfc'

Sample response

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

Response

{
    "errors": null,
    "validationErrors": null,
    "data": [
        {
            "accountPricelistId": "C001699449389",
            "pricelistCode": "DEBIT_CARD",
            "cardLevelPriceList": false,
            "validityRange": {
                "startDate": "2025-03-27",
                "endDate": null
            },
            "insertedBy": "John Officer",
            "insertedDtime": "2025-03-27T13:31:20.919Z"
        }
    ]
}

Result

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