Access the Calculation Results

Using the RebalancingModelGuid obtained from the api/rebalanceMode endpoint, retrieve the results of the calculation following the steps below.


Creating the Request

Create a new request in Postman as follows:

  1. Change the HTTP verb from POST to GET.
  2. Click on the Authorization tab and set the access token as the Bearer Token.
Authorization tab in Postman

Authorization tab in Postman

  1. Specify the URL to the api/RebalanceModel/{rebalancingModelGuid}/results API endpoint. For example, https://fslpresales.fslcgix-uat.co.uk/FSLPresales_WebAPI/api/RebalanceModel/d1684dd3-c555-4d17-6396-08dcf2a3cbe0/results

🚧

URL Encoding

The URL parameterrebalancingModelGuidshould be URL encoded.


Sending the Request

Click the Send button to send the prepared request.


The Response Body

When successful, the API response will return the following information in JSON format:

Property - Client DetailsDescription
clientIdCGiX Client ID
clientNameClient Name in CGiX
dateTimeStampDate 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 TotalsDescription
totalChargeableGainSum 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’
totalXISSum of gains of proposal plus current year gains attributed to only assets marked as excluded indexed securities
taxYearLossTotal allowable losses created within the current tax year, inclusive of any proposed trades
totalAllowablePreviousYearLossTotal allowable losses carried forward from previous tax years
lossOffsetTotal losses offset against gains in the current tax year
taxYearLossOffsetTotal losses offset against gains from current tax year loss
bfLossOffsetTotal losses offset against gains in the current tax year that relate to the previous year losses
totalTaperedGainTotal 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
indexationIndicates the monetary Indexation Value associated to the disposal transaction
lostIndexationTruncated Indexation – indexation lost due to the disposal not being able to increase a loss
netLossTotal allowable losses created within the current tax year, inclusive of any proposed trades
remainingAllowablePreviousYearLossAmount of losses that are remaining from brought forward losses that could not be utilised in this proposed disposal
unusedLossesTotal unused allowable losses carried forward from previous tax years
annualExemptionAnnual tax-free allowance
unusedExemptionExemption allowance remaining after subtracting the chargeable gain
lostTaperTotal amount of taper relief lost due to losses being offset against untapered gains, including any proposed trades
clientTotalProceedsTotal amount of proceeds that will be raised
gainLiableForCGTGain liable to CGT after applying loss offsets, and annual exemption allowance
chargeableGainLossSum 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’
deepDiscountedGainGains made against any assets which are classified as Deep-Discounted
offshoreGainProceeds minus expense for assets classified as Offshore funds that produce a gain
currencyISO Currency code of the asset
expenseUnknownTrue/false flag to indicate the totals are based on ‘Unknown’ suspect marker cost
suspectMarkerIndicates if the classification of the asset is suspect i.e. unknown
estimatedTrue/false flag to indicate the totals are based on ‘Estimated’ suspect marker cost
exemptTotalsGain/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
        }
    }
]