Term Deposit Insights
4 endpoints · WealthSync API
Get user linked accounts for term deposits.
This API returns all linked Term Deposit (FD) accounts for a user, grouped by FIP (Financial Information Provider). Each linked account includes details like account type, masked account number, holder info, balance, and consent status.
Request Body Parameters:
→ uniqueIdentifier (required): The primary identifier added at the time of subscription. It must be the exact same value used during the initial subscription and MUST never change for this user.
Headers
- X-API-KEYstringrequiredYour secret API key for the environment you are calling (Stage and Live use different keys).
- X-API-APP-IDstringrequiredThe App ID issued together with the key.
- Content-Typestringrequiredapplication/json
Body parameters
application/json- uniqueIdentifierstringrequiredRequired. Your identifier for the user, exactly as sent when the user was subscribed. Never changes for a user. Non-empty string.minLength 1default user-12345
Sample request body
Responses
200OK
- totalFiDatainteger (int32)optionalNo description.nullable
- totalFiDataToBeFetchedinteger (int32)optionalNo description.nullable
- lastFetchDatestring (date-time)optionalNo description.nullable
- fipDataarray<object>optionalNo description.nullable
Each item: 5 fields
- fipIdstringoptionalNo description.nullable
- fipNamestringoptionalNo description.nullable
- totalFiDatainteger (int32)optionalNo description.nullable
- totalFiDataToBeFetchedinteger (int32)optionalNo description.nullable
- linkedAccountsarray<object>optionalNo description.nullable
Each item: 13 fields
- fiDataIdstringoptionalNo description.nullable
- accountTypestringoptionalNo description.nullable
- maskedAccNumberstringoptionalNo description.nullable
- accountRefNumberstringoptionalNo description.nullable
- dataFetchedstringoptionalNo description.nullable
- accountNamestringoptionalNo description.nullable
- lastFetchDateTimestring (date-time)optionalNo description.nullable
- fipIdstringoptionalNo description.nullable
- fipNamestringoptionalNo description.nullable
- fiDataanyoptionalNo description.nullable
- latestConsentPurposeTextstringoptionalNo description.nullable
- latestConsentExpiryTimestring (date-time)optionalNo description.nullable
- consentPurposeVersionstringoptionalNo description.nullable
- dataSourceDetailsarray<object>optionalNo description.nullable
Each item: 2 fields
- dataResourceTypestringoptionalNo description.nullable
- lastFetchDatestringoptionalNo description.nullable
400Bad Request
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 400
401Unauthorized
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 401
500Internal Server Error
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 500
Code samplescurl · Node.js · Python
Get user FI details for term deposits.
This API retrieves the user's subscription status along with a summary of all Term Deposit FI data. It shows subscription start/end dates and a per-FIP account breakdown, indicating how many accounts are linked and how many have been fetched.
Request Body Parameters:
→ uniqueIdentifier (required): The primary identifier added at the time of subscription. It must be the exact same value used during the initial subscription and MUST never change for this user.
Headers
- X-API-KEYstringrequiredYour secret API key for the environment you are calling (Stage and Live use different keys).
- X-API-APP-IDstringrequiredThe App ID issued together with the key.
- Content-Typestringrequiredapplication/json
Body parameters
application/json- uniqueIdentifierstringrequiredRequired. Your identifier for the user, exactly as sent when the user was subscribed. Never changes for a user. Non-empty string.minLength 1default user-12345
Sample request body
Responses
200OK
- subscriptionStatusstringoptionalNo description.nullable
- subscriptionStartDatestringoptionalNo description.nullable
- subscriptionEndDatestringoptionalNo description.nullable
- fiDatasanyoptionalNo description.nullable
400Bad Request
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 400
401Unauthorized
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 401
500Internal Server Error
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 500
Code samplescurl · Node.js · Python
Download user account statement for term deposits.
This API downloads the term deposit account statement as a binary file (PDF/CSV). Use this for exporting or sharing the transaction history of a specific term deposit account.
Prerequisites:
→ First call POST term-deposit/user-linked-accounts to get the list of linked term deposit accounts.
→ From the response, pick the fiDataId of the desired account.
→ Pass that fiDataId as the "accountId" parameter in this API.
Request Body Parameters:
→ uniqueIdentifier (required): The primary identifier added at the time of subscription. It must be the exact same value used during the initial subscription and MUST never change for this user.
→ accountId (required): The fiDataId of the specific account.
→ txnOrder (optional): Sort order for transactions — "ASC" (oldest first) or "DESC" (newest first).
→ dateRangeFrom (optional): Start date for filtering transactions. Format: yyyy-MM-dd.
→ dateRangeTo (optional): End date for filtering transactions. Format: yyyy-MM-dd.
Headers
- X-API-KEYstringrequiredYour secret API key for the environment you are calling (Stage and Live use different keys).
- X-API-APP-IDstringrequiredThe App ID issued together with the key.
- Content-Typestringrequiredapplication/json
Body parameters
application/json- uniqueIdentifierstringrequiredRequired. Your identifier for the user, exactly as sent when the user was subscribed. Never changes for a user. Non-empty string.minLength 1default user-12345
- accountIdstringrequiredRequired. The fiDataId of the linked account, taken from the linked-accounts response.minLength 1default YOUR_FI_DATA_ID
- txnOrderstringoptionalOptional. Sort order of transactions. Allowed values: ASC (oldest first), DESC (newest first). Default: ASC.nullabledefault ASC
- dateRangeFromstringoptionalOptional. Start date to filter transactions, in yyyy-MM-dd format.nullabledefault 2024-01-01
- dateRangeTostringoptionalOptional. End date to filter transactions, in yyyy-MM-dd format.nullabledefault 2024-12-31
Sample request body
Responses
200OK
400Bad Request
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 400
401Unauthorized
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 401
500Internal Server Error
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 500
Code samplescurl · Node.js · Python
Get user account statement for term deposits.
This API returns the transaction history for a specific Term Deposit account. Each transaction includes txnId, amount, narration, type, mode, balance, and transaction datetime.
Prerequisites:
→ First call POST term-deposit/user-linked-accounts to get the list of linked term deposit accounts.
→ From the response, pick the fiDataId of the desired account.
→ Pass that fiDataId as the "accountId" parameter in this API.
Request Body Parameters:
→ uniqueIdentifier (required): The primary identifier added at the time of subscription. It must be the exact same value used during the initial subscription and MUST never change for this user.
→ accountId (required): The fiDataId of the specific account.
→ txnOrder (optional): Sort order for transactions — "ASC" (oldest first) or "DESC" (newest first).
→ dateRangeFrom (optional): Start date for filtering transactions. Format: yyyy-MM-dd.
→ dateRangeTo (optional): End date for filtering transactions. Format: yyyy-MM-dd.
Headers
- X-API-KEYstringrequiredYour secret API key for the environment you are calling (Stage and Live use different keys).
- X-API-APP-IDstringrequiredThe App ID issued together with the key.
- Content-Typestringrequiredapplication/json
Body parameters
application/json- uniqueIdentifierstringrequiredRequired. Your identifier for the user, exactly as sent when the user was subscribed. Never changes for a user. Non-empty string.minLength 1default user-12345
- accountIdstringrequiredRequired. The fiDataId of the linked account, taken from the linked-accounts response.minLength 1default YOUR_FI_DATA_ID
- txnOrderstringoptionalOptional. Sort order of transactions. Allowed values: ASC (oldest first), DESC (newest first). Default: ASC.nullabledefault ASC
- dateRangeFromstringoptionalOptional. Start date to filter transactions, in yyyy-MM-dd format.nullabledefault 2024-01-01
- dateRangeTostringoptionalOptional. End date to filter transactions, in yyyy-MM-dd format.nullabledefault 2024-12-31
Sample request body
Responses
200OK
400Bad Request
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 400
401Unauthorized
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 401
500Internal Server Error
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 500