Find card status history

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

Use case

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

Use case data	API parameters with values
Find all status changes related to card C001664282649.	...cards/C001664282649/status-history

Sample API call

To retrieve card status history, use the following endpoint:

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

Learn more about the find card status 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/status-history' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoidGVzdCBrYXN1dGFqYSIsImVtcGxveWVlSWQiOiJJRC0xMTAwIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA4LTI2VDE0OjUzOjU5IiwiZXhwIjoxNzU2MjIwMDM5LCJyb2xlcyI6WyJBRE1JTiIsIlNZU1RFTSJdfQ.hXId-9JHJCVEUNE4WzeUW8eVvQ2ZXrQTXS9BVp3yDOE'

Sample response

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

Response

{
    "errors": null,
    "validationErrors": null,
    "data": [
        {
            "statusFrom": "VIRTUAL",
            "statusTo": "ACTIVE",
            "reasonCode": null,
            "description": null,
            "insertedDTime": "2025-06-05T07:46:40.73Z",
            "insertedBy": "Card User"
        },
        {
            "statusFrom": "IN_CREATING",
            "statusTo": "VIRTUAL",
            "reasonCode": "FINISHED_CARD_CREATION",
            "description": null,
            "insertedDTime": "2025-03-27T13:31:23.836Z",
            "insertedBy": "System System"
        }
    ]
}

Result

The result of the API call is a complete list of card status codes, along with the insertedDTime indicating when each status transition occurred.