Access the Calculation Results
Using the RebalancingModelGuid obtained from the api/rebalanceMode endpoint, retrieve the results of the calculation following the steps below.
1. Creating the Request
Create a new request in Postman as follows:
- Change the
HTTP verbfrom POST to GET. - Click on the Authorization tab and set the access token as the
Bearer Token.
Authorization tab in Postman
- Specify the
URLto theapi/RebalanceModel/{rebalancingModelGuid}/resultsAPI endpoint. For example, https://fslpresales.fslcgix-uat.co.uk/FSLPresales_WebAPI/api/RebalanceModel/d1684dd3-c555-4d17-6396-08dcf2a3cbe0/results
URL Encoding
The URL parameter
rebalancingModelGuidshould be URL encoded.
2. Sending the Request
Click the Send button to send the prepared request.
3. The Response Body
When successful, the API response will return the following information in JSON format:
| Property - Client Details | Description |
|---|---|
| clientId | CGiX Client ID |
| clientName | Client Name in CGiX |
| dateTimeStamp | Date and time that the rebalancing calculation is run |
| Property - Holdings | Description |
|---|---|
| securityName | Name of the asset |
| sedol | 7 -character alphanumeric Stock Exchange Daily Official List identifier for the asset |
| isin | 12-character alphanumeric International Securities Identification Number for the asset |
| decimalPlaces | Number of decimal places the asset can be traded in |
| currency | Currency code of the security |
| unreconciled | Indicates if the holding is ‘Unreconciled’ or not True = Reconciliation False = No Reconciliation |
| totalHoldingShares | Total shares held for the asset prior to disposal |
| totalHoldingExpense | Expense for the total shares held of the asset prior to disposal |
| disposedShares | Proposed shares to be sold per asset |
| disposedExpense | Disposed expense for the proposed disposal per asset |
| indexation | Indicates the monetary Indexation Value associated to the asset holding |
| proceeds | Amount of proceeds related to proposed disposal |
| cgtExpense | Liable cost for shares disposed Or Cost of shares used for CGT liability |
| exemptExpense | Expense of exempt securities Will be populated when the asset holding is linked to a security classified as exempt from CGT |
| exemptProceeds | Proceeds of exempt securities Will be populated when the asset holding is linked to a security classified as exempt from CGT |
| marketValue | Market Value based on the recent price in the system for the total holding shares. |
| price | Recent price of the asset in the system that is used to calculate the Market Value. |
| percentageGainProceeds | Percentage of gain against the proceeds |
| lostIndexation | Truncated indexation – the amount of indexation lost as you cannot increase the loss on the disposal |
| gainLoss | Indicates the total notional gain/loss associated to the proposed asset disposal |
| chargeableGain | Sum of gains made on the proposed disposal plus current tax year gain. The total excludes gains made on holdings identified as ‘Exempt Holdings’ or ‘Excluded Indexed Securities’ |
| remainingLosses | Remaining allowable loss for the current tax year |
| suspectMarker | Indicates if the holding for the asset being proposed for disposal is made up of suspect transaction i.e. unconfirmed book cost 0 = No Suspect 1 = Estimated Cost 2 = Unknown Cost |
| minShares | Minimum number of shareholdings for an asset in a list of clients under valuation. This is not yet supported on all endpoints. |
| disposedIndexation | Amount of Indexation allowance against the disposed shares |
| disposedIndexedCost | Amount of expense against the disposed shares inclusive of Indexation |
| percentageHolding | Percentage of the holding being disposed |
| transactionType | Sale or Purchase. A purchase may be sent for volatile disposal to perform a buy back for volatile holdings. This is not yet supported on all endpoints. |
| Property - Assets | Description |
|---|---|
| acquiredDate | Acquisition Date of the acquisition which is being used to calculate the CGT for the disposal transaction record |
| gainDate | Date of disposal |
| identification | Identification rule that was used for the associated underlying asset disposal |
| totalHoldingShares | Actual number of shares held by the pool |
| totalHoldingExpense | Expense for the total shares held of the asset prior to disposal |
| percentageHolding | Percentage of the holding being disposed in the Identification pool |
| lostIndexation | Truncated Indexation – indexation lost due to the disposal not being able to increase a loss |
| disposedIndexationPerAcquisition | Indexation allowance against disposed shares in the Identification pool |
| disposedExpensePerAcquisition | Proportion of expense which has been used from the identification pool and used to calculate the overall CGT amount for the disposal transaction record |
| disposedLossOffsetPerAcquisition | Proportion of losses being used to offset any gains which have been allocated to the identification pool and used to calculate the overall CGT amount for the disposal transaction record |
| disposedSharePerAcquisition | Number of shares sold attributed to the share identification |
| disposedGainPerAcquisition | Monetary gain or loss associated to the disposal transaction per share identification pool |
| disposedProceedsPerAcquisition | Proceed for the relevant shares associated with the share identification pool |
| disposedIndexedCostPerAcquisition | Indexed cost per share identification pool (Expense + Indexation) |
| percentageGainProceeds | Percentage of gain against the proceeds per share identification pool |
| marketValue | Market Value based on the recent price in the system for the total holding shares for that share identification pool |
| suspectMarker | Indicates if the figures are based on suspect classification of the asset i.e. unknown |
| assetType | This is not yet supported on all endpoints |
| exempt | True if the associated underlying asset is exempt from CGT False if the associated underlying asset is liable to CGT |
| disposedTaperedGainPerAcquisition | Monetary gain or loss associated to the disposal transaction per share identification p |
| Property - Tax Year Totals | Description |
|---|---|
| totalChargeableGain | Sum of gains made on the proposed disposal plus the current tax year gain. Total excludes gains made on holdings identified as ‘Exempt Holdings’ or ‘Excluded Indexed Securities’ |
| totalXIS | Sum of gains of proposal plus current year gains attributed to only assets marked as excluded indexed securities |
| taxYearLoss | Total allowable losses created within the current tax year, inclusive of any proposed trades |
| totalAllowablePreviousYearLoss | Total allowable losses carried forward from previous tax years |
| lossOffset | Total losses offset against gains in the current tax year |
| taxYearLossOffset | Total losses offset against gains from current tax year loss |
| bfLossOffset | Total losses offset against gains in the current tax year that relate to the previous year losses |
| totalTaperedGain | Total chargeable gains for the tax year after applying loss offsets and taper relief, inclusive of any proposed trades. If the overall net position for the year is a loss, this will show the overall loss amount |
| indexation | Indicates the monetary Indexation Value associated to the disposal transaction |
| lostIndexation | Truncated Indexation – indexation lost due to the disposal not being able to increase a loss |
| netLoss | Total allowable losses created within the current tax year, inclusive of any proposed trades |
| remainingAllowablePreviousYearLoss | Amount of losses that are remaining from brought forward losses that could not be utilised in this proposed disposal |
| unusedLosses | Total unused allowable losses carried forward from previous tax years |
| annualExemption | Annual tax-free allowance |
| unusedExemption | Exemption allowance remaining after subtracting the chargeable gain |
| lostTaper | Total amount of taper relief lost due to losses being offset against untapered gains, including any proposed trades |
| clientTotalProceeds | Total amount of proceeds that will be raised |
| gainLiableForCGT | Gain liable to CGT after applying loss offsets, and annual exemption allowance |
| chargeableGainLoss | Sum of gains made on the proposed disposal plus the current tax year gain. The total excludes gains made on holdings identified as ‘Exempt Holdings’ or ‘Excluded Indexed Securities’ |
| deepDiscountedGain | Gains made against any assets which are classified as Deep-Discounted |
| offshoreGain | Proceeds minus expense for assets classified as Offshore funds that produce a gain |
| currency | ISO Currency code of the asset |
| expenseUnknown | True/false flag to indicate the totals are based on ‘Unknown’ suspect marker cost |
| suspectMarker | Indicates if the classification of the asset is suspect i.e. unknown |
| estimated | True/false flag to indicate the totals are based on ‘Estimated’ suspect marker cost |
| exemptTotals | Gain/loss associated to asset holdings marked as ‘Exempt’ |
Example response:
[
{
"clientId": "100200300",
"clientName": "Mr A Smith",
"dateTimeStamp": "2025-01-27T14:03:13.3882607+00:00",
"holdings": [
{
"securityName": "Credit Suisse AG London Branch Underlying Tracker 2017-20.12.23 (Exp.12.12.23) on Andrea Investment",
"sedol": "BYVRX75",
"isin": "XS1678714616",
"decimalPlaces": 0,
"currency": "GBP",
"unreconciled": true,
"totalHoldingShares": 12150,
"totalHoldingExpense": 141180.0000,
"disposedShares": 12000,
"disposedExpense": 138725.4500,
"indexation": 0.0000,
"proceeds": 18054.13,
"cgtExpense": null,
"exemptExpense": 0.0000,
"exemptProceeds": 0.0000,
"marketValue": 18279.81,
"price": 1.504511,
"percentageGainProceeds": -668.38623627945517175294517099,
"lostIndexation": 0.0000,
"gainLoss": -120671.3200,
"chargeableGain": -120671.32,
"remainingLosses": null,
"suspectMarker": 0,
"minShares": null,
"disposedIndexation": 0.0000,
"disposedIndexedCost": 138725.4500,
"percentageHolding": "98.77% ",
"transactionType": "Sale",
"assets": [
{
"acquiredDate": "2023-08-18T00:00:00",
"gainDate": "0001-01-01T00:00:00",
"identification": "Excluded Indexed Securities (LIFO)",
"totalHoldingShares": 6650,
"totalHoldingExpense": 51180.0000,
"percentageHolding": "54.73% ",
"lostIndexation": 0.0000,
"disposedIndexationPerAcquisition": 0.0000,
"disposedExpensePerAcquistion": 51180.0000,
"disposedLossOffsetPerAcquistion": 0,
"disposedSharePerAcquistion": 6650,
"disposedGainPerAcquisition": -41175.0000,
"disposedProceedsPerAcquistion": 10005.0000,
"disposedIndexedCostPerAcquisition": 51180.0000,
"percentageGainProceeds": -411.54422788605697151424287856,
"marketValue": 10005.0000,
"suspectMarker": null,
"assetType": 0,
"exempt": 0.0000,
"disposedTaperedGainPerAcquisition": -41175.0000
},
{
"acquiredDate": "2018-02-25T00:00:00",
"gainDate": "0001-01-01T00:00:00",
"identification": "Excluded Indexed Securities (LIFO)",
"totalHoldingShares": 5500,
"totalHoldingExpense": 90000.0000,
"percentageHolding": "44.03% ",
"lostIndexation": 0.0000,
"disposedIndexationPerAcquisition": 0.0000,
"disposedExpensePerAcquistion": 87545.4500,
"disposedLossOffsetPerAcquistion": 0,
"disposedSharePerAcquistion": 5350,
"disposedGainPerAcquisition": -79496.3200,
"disposedProceedsPerAcquistion": 8049.1300,
"disposedIndexedCostPerAcquisition": 87545.4500,
"percentageGainProceeds": -987.6386640543760630030823207,
"marketValue": 8274.8100,
"suspectMarker": null,
"assetType": 0,
"exempt": 0.0000,
"disposedTaperedGainPerAcquisition": -79496.3200
}
]
},
{
"securityName": "Shell PLC Registered Shs",
"sedol": "BP6MXD8",
"isin": "GB00BP6MXD84",
"decimalPlaces": 0,
"currency": "GBP",
"unreconciled": true,
"totalHoldingShares": 1350,
"totalHoldingExpense": 144000.0000,
"disposedShares": 1000,
"disposedExpense": 106666.6700,
"indexation": 0.0000,
"proceeds": 23755.00,
"cgtExpense": null,
"exemptExpense": 0.0000,
"exemptProceeds": 0.0000,
"marketValue": 34485.75,
"price": 25.545000,
"percentageGainProceeds": -349.02828878130919806356556514,
"lostIndexation": 0.0000,
"gainLoss": -82911.6700,
"chargeableGain": -82911.67,
"remainingLosses": null,
"suspectMarker": 0,
"minShares": null,
"disposedIndexation": 0.0000,
"disposedIndexedCost": 106666.6700,
"percentageHolding": "74.07% ",
"transactionType": "Sale",
"assets": [
{
"acquiredDate": "2023-02-02T00:00:00",
"gainDate": "0001-01-01T00:00:00",
"identification": "Section 104 Holding",
"totalHoldingShares": 1350,
"totalHoldingExpense": 144000.0000,
"percentageHolding": "74.07% ",
"lostIndexation": 0.0000,
"disposedIndexationPerAcquisition": 0.0000,
"disposedExpensePerAcquistion": 106666.6700,
"disposedLossOffsetPerAcquistion": 0,
"disposedSharePerAcquistion": 1000,
"disposedGainPerAcquisition": -82911.6700,
"disposedProceedsPerAcquistion": 23755.0000,
"disposedIndexedCostPerAcquisition": 106666.6700,
"percentageGainProceeds": -349.02828878130919806356556514,
"marketValue": 34485.7500,
"suspectMarker": null,
"assetType": 0,
"exempt": 0.0000,
"disposedTaperedGainPerAcquisition": -82911.6700
}
]
}
],
"volatileSales": [],
"taxYearTotals": {
"totalChargeableGain": 0.0000,
"totalXIS": 0.0000,
"taxYearLoss": 308707.6900,
"totalAllowablePreviousYearLoss": 8400.0000,
"lossOffset": 0.0000,
"taxYearLossOffset": 0.0000,
"bfLossOffset": 0.0000,
"totalTaperedGain": 0.0000,
"indexation": 0.0000,
"lostIndexation": 0.0000,
"netLoss": 308707.6900,
"remainingAllowablePreviousYearLoss": 8400.0000,
"unusedLosses": 317107.6900,
"annualExemption": 3000.0000,
"unusedExemption": 3000.0000,
"lostTaper": 0.0000,
"clientTotalProceeds": 60801.0700,
"gainLiableForCGT": 0.0000,
"chargeableGainLoss": -308707.6900,
"deepDiscountedGain": 299.1900,
"offshoreGain": 4570.4900,
"currency": "GBP",
"expenseUnknown": 0,
"suspectMarker": 0,
"estimated": 0,
"exemptTotals": 2677.5000
}
}
]
Updated 2 days ago