FAQs

Find below a list of commonly asked questions

Frequently Asked Questions

Do requests need to be paginated?

No, the Sesame Data APIs are unpaginated, meaning all data is returned in a single response.

How are NULL fields handled in the response?

NULL results which are part of a response element are not returned. Certain fields are mandatory. See API Endpoints.

How do I know which portfolio each bank account's data is being stored in?

In the entities endpoint, the PORTFOLIO.CODE field connects the portfolio to the identifier used by banks, brokers and custodians to identify each bank account.

Do you separate different asset types between endpoints?

No. All positions (regardless of the underlying asset type) are found in the /positions endpoint. Similarly, all transactions (regardless of the underlying asset type) are all found in the /transactions endpoint.

How are cash transactions and positions treated?

Like any other asset or liability, different currencies have their own ASSET.ID, and any positions or transactions on these will be available via those endpoints.

Why does the /positions endpoint have sub portfolio information?

Where a feed shares this granularoty, on a given date, the sub portfolio data decomposes a single cash position into multiple cash balances per SUB_PORTFOLIO_CODE. SUB_PORTFOLIO_CODE can also be referred to as broker code or broker account code. In POSITION.MARKET_VALUE_LOCAL, these cash positions in the same currency are aggregated in a single balance.

POSITION.GRANULARITY > SUB_PORTFOLIO > SUB_PORTFOLIO_CODE is distinct per position.

How do you handle transactions which are reversals of previous transactions?

In the /transactions endpoint, the TRANSACTION.REVERSAL field will indicate if a transaction is a reversal by way of a true/false flag. Where true, the directions of fields like TRANSACTION.MOVEMENT_LOCAL and TRANSACTION.MOVEMENT_REPORTING will be opposite to those from the original transaction. Where available, the field TRANSACTION.CUSTODIAN_REVERSED_TRANSACTION_ID will link the reversal and original transactions.

What if I have a query about the data returned in the response, or the data does not reflect what is in my bank statement?

Use the Sesame support chat, and provide the cURL of your request.

What if I have an error message that I cannot resolve?

Use the Sesame support chat, and provide the cURL of your request.