Find card account details

Here, you will learn how to retrieve card account details in Tuum.

Use case

In this example, we will review how to find card account details by using the account ID, along with the associated card price lists.

Use case data	API parameters with values
Searching for details of account C001664282646.	...accounts/C001664282646

Sample API call

To find card account details, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v3/accounts/{accountId}

Learn more about the find account details endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

Body

No request body.

cURL

Sample response

Below you will find the response to the API request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "accountId": "C001664282646",
        "personId": "ID-3438",
        "accountType": {
            "accountTypeCode": "CURRENT",
            "groupCode": "CURRENT",
            "onetimeFeeRuleCode": "TRANSACTION",
            "transactionFeeRuleCode": "TRANSACTION",
            "overlimitFeeRuleCode": "TRANSACTION"
        },
        "accountNumber": null,
        "statusCode": "ACTIVE",
        "defaultCurrencyCode": "EUR",
        "priceList": {
            "priceListCode": "DEBIT_CARD_2",
            "validityRange": {
                "startDate": "2025-06-11",
                "endDate": null
            }
        },
        "cardPriceLists": [
            {
                "cardId": "C001664282666",
                "priceListCode": "DEBIT_CARD",
                "validityRange": {
                    "startDate": "2025-07-03",
                    "endDate": null
                }
            },
            {
                "cardId": "C001664282659",
                "priceListCode": "DEBIT_CARD",
                "validityRange": {
                    "startDate": "2025-06-10",
                    "endDate": null
                }
            },
            {
                "cardId": "C001664282651",
                "priceListCode": "DEBIT_CARD",
                "validityRange": {
                    "startDate": "2025-06-10",
                    "endDate": null
                }
            },
            {
                "cardId": "C001664282650",
                "priceListCode": "DEBIT_CARD_2",
                "validityRange": {
                    "startDate": "2025-06-11",
                    "endDate": null
                }
            }
        ],
        "source": null,
        "countryCode": "EE",
        "activationDate": "2025-06-10",
        "tenantCode": "MB"
    }
}

Result

The outcome of the API call is a complete set of card account details, including both account-level and card-level price lists.

Parameter and value	Explanation
"priceList": { "priceListCode": "DEBIT_CARD_2", "validityRange": { "startDate": "2025-06-11", "endDate": null } }	The account-level price list is used to calculate fees when no card ID is provided as input. It represents the most recent price list associated with the main card linked to the account.
"cardPriceLists": [ { "cardId": "C001664282666", "priceListCode": "DEBIT_CARD", "validityRange": { "startDate": "2025-07-03", "endDate": null } }, { "cardId": "C001664282659", "priceListCode": "DEBIT_CARD", "validityRange": { "startDate": "2025-06-10", "endDate": null } }, { "cardId": "C001664282651", "priceListCode": "DEBIT_CARD", "validityRange": { "startDate": "2025-06-10", "endDate": null } }, { "cardId": "C001664282650", "priceListCode": "DEBIT_CARD_2", "validityRange": { "startDate": "2025-06-11", "endDate": null } } ]	This is a list of cards linked to the given account, along with their assigned price lists.