Find card renewal details

Here, you will learn how to find card renewal details in Tuum.

Use case

In this example, we will demonstrate how to access card renewal details after the renewal process has been initiated automatically by the system or manually using the start card renewal manually endpoint.

Use case data	API parameters with values
Find the card renewal details for card C001664282660.	...cards/C001664282660/renewal

Sample API call

To find card renewal details, use the following endpoint:

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

Learn more about the card renewal details endpoint in the Tuum developer portal.

Sample request

Here is a sample API request for retrieving card renewal details:

Body

No request body.

cURL

curl -L 'https://card-api.sandbox.tuumplatform.com/api/v1/cards/C001664282660/renewal' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoidGVzdCBrYXN1dGFqYSIsImVtcGxveWVlSWQiOiJJRC0xMTAwIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA5LTA0VDA4OjEyOjE2IiwiZXhwIjoxNzU2OTczNTM2LCJyb2xlcyI6WyJBRE1JTiIsIlNZU1RFTSJdfQ.qNiJX4m6OMVK_zhPUuwtnZ0r_8HU1wEUf6a0ej8IPEE'

Sample response

Below you will find the response to the API request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "cardRenewalId": "C001664282472",
        "cardId": "C001664282660",
        "panReference": "1778880286830851528",
        "productCode": "INTERNAL_ACCOUNT_6MONTH_M",
        "productScheme": "MASTERCARD",
        "productClass": "DEBIT",
        "productType": "PHYSICAL",
        "accountId": "C001664282651",
        "personId": "ID-30496",
        "statusCode": "FINISHED",
        "expiryDate": "2025-12-31",
        "renewalCreatedDateTime": null,
        "designCode": "12",
        "mainCardId": null,
        "accountOwnerPersonId": "ID-30496",
        "deliveryAddress": {
            "postCode": "10145",
            "countryCode": "EE",
            "city": "Tallinn",
            "county": "Harju",
            "streetAddress": "Maakri 30",
            "phoneCountryCode": "+372",
            "phoneNumber": "55555555"
        },
        "shippingDetailsId": "C001664282683",
        "cardDeliveryMethod": "COURIER",
        "tenantCode": "MB"
    }
}

Result

The API response returns a dataset containing the card renewal details, including parameters generated by the Tuum system.

Parameter and value	Explanation
"cardRenewalId": "C001664282472"	A unique identifier is assigned to the card renewal. The cardRenewalId is required to update, approve, reject, or complete a card renewal.
"statusCode": "WAITING"	The renewal is created and set to a 'waiting for review' status.