Find savings ID for savings account

A savings ID is a unique identifier used to link a savings order to its associated savings account. It is generated separately and serves as a reference during savings order creation.

The savings account ID in this example is the same as the one created in the previous section. If the savings ID is not already known, it can be retrieved by following the example below.

Use case

In this example, we will retrieve a savings ID, which is required to create a savings order.

Use case data	API parameters with values
The savings ID will be retrieved for the savings account ID-23941.	...accounts/saving-accounts/ID-23941/savings

Sample API call

To retrieve a savings ID for savings account, use the following endpoint:

https://account-api.sandbox.tuumplatform.com/api/v3/accounts/saving-accounts/{savingAccountId}/savings

Learn more about the returns saving for a saving account endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

JSON

No request body.

cURL

curl -L 'https://account-api.sandbox.tuumplatform.com/api/v3/accounts/saving-accounts/ID-23941/savings' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoidGVzdCBrYXN1dGFqYSIsImVtcGxveWVlSWQiOiJJRC0xMTAwIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA5LTI5VDEzOjU3OjMwIiwiZXhwIjoxNzU5MTU0MjUwLCJyb2xlcyI6WyJBRE1JTiJdfQ.P3ug4ax2vc6OXYoZ3I4RmeeA2rOPbREnTOR4QiJKoYY' \
-H 'Content-Type: application/json'

Sample response

Below you will find the response to the API request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "savingId": "ID-1491",
        "savingAccountId": "ID-23941",
        "currencyAccountId": "ID-23819",
        "savingName": "Emergency savings",
        "firstDebitDate": "2033-06-01",
        "lastDebitDate": null,
        "savingEndDate": "2040-05-18",
        "nextDebitDate": "2033-06-01",
        "currencyCode": "EUR",
        "interestRate": 3.10,
        "savingAmount": 1000,
        "initialAmount": 10,
        "orderAmount": 50,
        "savingDay": 1,
        "frequency": "MONTHLY",
        "manuallyEnded": false,
        "errorCode": null,
        "accountInterests": [
            {
                "accountInterestMethodId": "ID-000000015023",
                "accountTypeInterestMethodId": "ID-000000001290",
                "currencyCode": "EUR",
                "interestGroupCode": "DEPOSIT",
                "nextInterestCalculationDate": "2033-05-11",
                "balanceTypeCode": "END_OF_DAY",
                "calculationBaseTermCode": "SIMPLE",
                "rateTypeCode": "FIXED",
                "calcDaysMonth": "30",
                "calcDaysYear": "360",
                "paymentIntervalTypeCode": "MONTH",
                "minPayableInterestAmount": 0.01,
                "marginTypeCode": null,
                "conditions": [
                    {
                        "accountInterestConditionId": "ID-000000033574",
                        "amountRange": null,
                        "interestRate": 3.1,
                        "ratePeriodTypeCode": "PER_YEAR",
                        "interestTypeCode": "ACCO_INT",
                        "validityRange": {
                            "startDate": "2033-05-11",
                            "endDate": null
                        },
                        "source": null,
                        "rateBaseCode": null,
                        "baseRate": null,
                        "marginRate": null
                    }
                ]
            }
        ],
        "interestBalances": [],
        "accountNumbers": [
            {
                "accountNumberId": "ID-15148",
                "accountId": "ID-23941",
                "accountNumber": {
                    "value": "XX20XXXX99999000000000000127872",
                    "type": "IBAN"
                },
                "countryCode": "XX",
                "financialInstitutionId": {
                    "value": "ICECLOUDXXX",
                    "type": "BIC"
                },
                "accountNumberSubtype": null,
                "defaultCurrencyCode": "EUR",
                "statusCode": "ENABLED",
                "externalSyncEnabled": false,
                "validityRange": {
                    "endTime": null,
                    "startTime": "2025-10-14T07:31:32.92Z"
                }
            }
        ]
    }
}

Result

The savings ID has been successfully retrieved for the specified savings account. It will be used to reference the account when setting up savings orders.