Basic Take Operations

Available operations

 

  • applicationBalance: Provides the balance, including pending transactions, for a specific application.
  • assetTransactionParticipation: Summarizes involvement in asset transactions.
  • bankActivity: Lists all banking activities related to the client.
  • bankTransaction: Offers raw bank transaction details for reconciliation.
  • ClientFundsAndTranches: Developers' utility function: Retrieves details about the funds and tranches we manage for you

Important:

  • Data retrieved using the Take operations will be held in the API database for a maximum of two days. If historical data is required, this can be provided on request.
  • API data should not be considered exhaustive, timely, nor complete. Download and store data locally for reference, auditing, and validation purposes.
  • This data should not be shared with clients "as is."
  • Data is verified to the best of our ability but remains subject to validation.

We provide four operations that you may use in your operations.

1.      Current Cash Balance: Represents the current cash balance of each applicant in fund bank accounts, including pending payments (i.e., un-cleared deposits or bank-instructed payments not yet reflected on statements). Multiple bank accounts may exist for each fund and tranche.

Use: applicationBalance.

2.      Reconciliations: Includes all reconciliations made for each application. This allows retrieval of the application balance noted earlier. Figures in the applicationBalance are aggregates by application and account of these records.

Use: bankActivity.

3.      Asset holding data: Refers to investments acquired and disposed of on behalf of applicants within the fund.

Use: assetTransactionParticipation.

4.      Bank Transaction Data: All raw bank transactions we retrieve from the banks accounts used to service your funds.

Use: bankTransaction.

Please click here to access the operations

Reconciliation Overview

When applicants invest in a fund, they transfer funds to designated bank accounts, forming a cash balance linked to specific applications. Daily reconciliations are automated using Customer Reference matching, with oversight for unmatched transactions. Complex reconciliations may allocate a single transaction across multiple applications. Unmatched deposits are flagged as "Unknown" for further review.

Various transactions (e.g. distributions) are reconciled as per your instructions via ITO Give operations.

Use: bankActivity.

Asset Holdings

We maintain records about the investments acquired and disposed of on behalf of applicants in the fund.

You provide us with instructions regarding asset transactions in which your investors commit to participate. We record the amounts each applicant spends or receives, as well as the shares they acquire or relinquish. In most cases, there is a corresponding bank transaction for each investor’s participation (or the relevant fraction of the transaction).

When an asset is purchased or sold, there is typically a single bank transaction. You will report the corresponding fraction for each investor participating in the transaction individually to us via the ITOGive operation in the API. We then allocate the cash element to each investor’s application cash account and update our asset holding records for them.

In certain scenarios, shares may be acquired or disposed of without any monetary exchange. In such cases, the movement is reflected solely in the allocation table. For example, this may occur when an asset company is dissolved, or shares are transferred to another individual.

Use: assetTransactionParticipation.

Using this data in your organisation

Reconciliation

If you currently reconcile investor receipts against bank statements, you can use the bankActivity operation to replace that task, as this is a primary funtion we undertake for you in our role and this data is our checked conclusion of that reconcilliation.

We ensure our data is compiled with utmost care and accuracy at the time of publication. However, banks may occasionally return deposits or payments. If you prefer to maintain your own reconciliation process for added assurance, you can compare your results against ours after reconciliation.

If you still wish to reconcile investor receipts against bank statements yourselves, you can use the bankTransaction operation get the statemented transactions, if this has been agreed with us.

Balance reporting on your portal

Even if you manage reconciliation data, pending payments instructed by banks may not be visible to you. This could mislead applicants into under or overestimating their cash account balances..

You can use the applicationBalance operation to retrieve, store, and report the figures we provide, with the caveat that some information might be out of date.

Shareholding reporting on your portal

You will maintain data on your investors participation in the asset transactions, but we have tested and mature data structures to record transfers of assets between investors and subsequent beneficiaries. From experience we appreciate this is onerous to maintain. Our records are checked, and are corroborated by the documentation we hold. You should use the data you can gain from us to validate the information you hold. Use assetTransactionParticipation.