{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "type": "object",
    "properties": {
        "year": {
            "title": "Year",
            "description": "The ending year of the tax year to which the calculation relates, in the format YYYY. For example, tax year 2016 to 2017 is expressed as 2017. Value must be between 2016 and 2999.",
            "type": "number",
            "example": "2019",
            "pattern": "^(201[6-9]|20[2-9][0-9])$"
        },
        "intentToCrystallise": {
            "title": "Intent To Crystallise",
            "description": "Shows if this calculation is provided with the intent to crystallise. The default is FALSE",
            "type": "boolean",
            "example": "false"
        },
        "crystallised": {
            "title": "Crystallised",
            "description": "Shows if the calculation has been performed on the crystallised position. The default is FALSE",
            "type": "boolean",
            "example": "false"
        },
        "validationMessageCount": {
            "title": "Validation Message Count",
            "description": "The quantity of validation messages encountered during the calculation.",
            "type": "number",
            "example": "1",
            "minimum": 0
        },
        "incomeTaxAndNicYTD": {
            "title": "Income Tax And Nic YTD",
            "description": "The Income Tax and National Insurance contributions due, based on year-to-date figures. The value must be between -99999999999.99 and 99999999999.99 up to 2 decimal places. This field will not be displayed if a business validation failure occurred processing the tax calculation",
            "type": "number",
            "example": "1000.25",
            "minimum": -99999999999.99,
            "maximum": 99999999999.99
        },
        "nationalRegime": {
            "title": "National Regime",
            "description": "Defines which national tax rates and rules to apply to the calculation. Must be one of: UK, Scotland, Wales. This field will not be present if a business validation failure occurred processing the tax calculation.",
            "type": "string",
            "oneOf": [
                {
                    "enum": [
                        "UK"
                    ]
                },
                {
                    "enum": [
                        "Scotland"
                    ]
                },
                {
                    "enum": [
                        "Wales"
                    ]
                }
            ]
        },
        "taxableIncome": {
            "type": "object",
            "description": "This object analyses how taxable income is derived. This object will not be present if a business validation failure occurred processing the tax calculation.",
            "properties": {
                "employments": {
                    "type": "object",
                    "properties": {
                        "totalIncome": {
                            "title": "Total Income",
                            "description": "The total income from all employments. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "totalPay": {
                            "title": "Total Pay",
                            "description": "The total net pay from all employments. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "totalBenefitsAndExpenses": {
                            "title": "Total Benefits And Expenses",
                            "description": "The total benefits and expenses from all employments. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "totalAllowableExpenses": {
                            "title": "Total Allowable Expenses",
                            "description": "The total allowable expenses from all employments. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "employment": {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "employmentId": {
                                        "title": "Employment ID",
                                        "description": "The identifier of the employment.",
                                        "type": "string",
                                        "example": "XKIS00000000968",
                                        "pattern": "^[A-Za-z0-9]{15}$"
                                    },
                                    "netPay": {
                                        "title": "Net Pay",
                                        "description": "The year-to-date net pay for this employment. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "benefitsAndExpenses": {
                                        "title": "Benefits And Expenses",
                                        "description": "The benefits and expenses relating to this employment. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "allowableExpenses": {
                                        "title": "Allowable Expenses",
                                        "description": "The allowable expenses relating to this employment. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    }
                                }
                            }
                        }
                    }
                },
                "selfEmployments": {
                    "type": "object",
                    "description": "This object summarises income for all self-employment sources",
                    "properties": {
                        "totalIncome": {
                            "title": "Total Income",
                            "description": "The total income from all self-employments. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "selfEmployment": {
                            "type": "array",
                            "description": "Provides the taxable income for each individual self-employment",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "selfEmploymentId": {
                                        "title": "Self-Employment ID",
                                        "description": "An identifier for the self-employment business, unique to the customer.",
                                        "type": "string",
                                        "example": "XKIS00000000988",
                                        "pattern": "^[A-Za-z0-9]{15}$"
                                    },
                                    "taxableIncome": {
                                        "title": "Taxable Income",
                                        "description": "The taxable income from this self-employment business. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "finalised": {
                                        "title": "Finalised",
                                        "description": "Shows whether this self-employment income has been finalised.",
                                        "type": "boolean",
                                        "example": "false"
                                    },
                                    "losses": {
                                        "title": "Losses",
                                        "description": "Any loss from this self-employment. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    }
                                }
                            }
                        }
                    }
                },
                "ukProperty": {
                    "type": "object",
                    "description": "This object summarises the UK property income sources",
                    "properties": {
                        "totalIncome": {
                            "title": "Total Income",
                            "description": "The total income from all UK property. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "nonFurnishedHolidayLettingsTaxableProfit": {
                            "title": "Non-Furnished Holiday Lettings Taxable Profit",
                            "description": "Taxable profit from UK non-furnished holiday lettings. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "nonFurnishedHolidayLettingsLoss": {
                            "title": "Non-Furnished Holiday Lettings Taxable Loss",
                            "description": "Loss from UK non-furnished holiday lettings. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "furnishedHolidayLettingsTaxableProfit": {
                            "title": "Furnished Holiday Lettings Taxable Profit",
                            "description": "Taxable profit from UK furnished holiday lettings. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "furnishedHolidayLettingsLoss": {
                            "title": "Furnished Holiday Lettings Taxable Loss",
                            "description": "Loss from UK furnished holiday lettings. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "finalised": {
                            "title": "Finalised",
                            "description": "Shows whether the UK property income has been finalised.",
                            "type": "boolean",
                            "example": "false"
                        }
                    }
                },
                "savings": {
                    "title": "Savings",
                    "type": "object",
                    "description": "This object summarises interest from UK banks, building societies and securities",
                    "properties": {
                        "totalIncome": {
                            "title": "Total Income",
                            "type": "number",
                            "description": "The taxable amount of interest from UK banks, building societies and securities. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "taxedAccounts": {
                            "title": "Taxed Accounts",
                            "type": "array",
                            "description": "An array of savings accounts where interest has had tax deducted",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "gross": {
                                        "title": "Gross",
                                        "type": "number",
                                        "description": "The gross interest for the savings account. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "savingsAccountId": {
                                        "title": "Savings Account ID",
                                        "type": "string",
                                        "description": "The unique identifier of the savings account",
                                        "example": "SAVKB2UVwUTBQGJ"
                                    },
                                    "name": {
                                        "title": "Name",
                                        "type": "string",
                                        "description": "Friendly account name. The account name must be between 1 and 32 characters in length. Allowed characters, including spaces are: mixed case alphanumeric characters and the characters; &'()*,-./@\u00a3"
                                    },
                                    "net": {
                                        "title": "Net",
                                        "type": "number",
                                        "description": "The net interest for the savings account. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "taxDeducted": {
                                        "title": "Tax Deducted",
                                        "type": "number",
                                        "description": "The tax deducted from the savings account (gross minus net). The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    }
                                }
                            }
                        },
                        "totalTaxedInterestIncome": {
                            "title": "Total Taxed Interest Income",
                            "type": "number",
                            "description": "Total gross interest from all taxed savings accounts. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "totalUntaxedInterestIncome": {
                            "title": "Total Untaxed Interest Income",
                            "type": "number",
                            "description": "Total interest from all untaxed savings accounts. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "untaxedAccounts": {
                            "title": "Untaxed Accounts",
                            "type": "array",
                            "description": "An array of savings accounts where no tax has been deducted",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "gross": {
                                        "title": "Gross",
                                        "type": "number",
                                        "description": "The gross interest for the savings account. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "savingsAccountId": {
                                        "title": "Savings Account ID",
                                        "type": "string",
                                        "description": "The unique identifier of the savings account",
                                        "example": "SAVKB2UVwUTBQGJ"
                                    },
                                    "name": {
                                        "title": "Name",
                                        "type": "string",
                                        "description": "Friendly account name. The account name must be between 1 and 32 characters in length. Allowed characters, including spaces are: mixed case alphanumeric characters and the characters; &'()*,-./@\u00a3"
                                    }
                                }
                            }
                        }
                    }
                },
                "ukDividends": {
                    "type": "object",
                    "description": "This object summarises the UK dividends income",
                    "properties": {
                        "totalIncome": {
                            "title": "Total Income",
                            "description": "The total income from all UK dividends. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "otherUkDividends": {
                            "title": "Other UK Dividends",
                            "type": "number",
                            "description": "The total dividend payments received from other UK dividends. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "ukDividends": {
                            "title": "UK Dividends",
                            "type": "number",
                            "description": "The total dividend payments received from UK companies. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        }
                    }
                },
                "totalIncomeReceived": {
                    "type": "number",
                    "title": "Total Income Received",
                    "description": "The total income received for the tax year. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "allowancesAndDeductions": {
                    "type": "object",
                    "description": "This object summarises the allowances and adjustments for the Tax Year",
                    "properties": {
                        "totalAllowancesAndDeductions": {
                            "title": "Total Allowances And Deductions",
                            "description": "The total of all allowances and deductions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "giftOfInvestmentsAndPropertyToCharity": {
                            "title": "Gift Of Investments And Property To Charity",
                            "description": "Investments and/or property gifts made to charity. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "apportionedPersonalAllowance": {
                            "title": "Apportioned Personal Allowance",
                            "description": "The amount of the annual personal allowance that has been apportioned. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        }
                    }
                },
                "totalTaxableIncome": {
                    "type": "number",
                    "title": "Total Taxable Income",
                    "description": "The total taxable income (income less allowances and deductions). The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                }
            }
        },
        "incomeTax": {
            "type": "object",
            "description": "This object gives a breakdown of the income tax calculation. This object will not be present if a business validation failure occurred processing the tax calculation.",
            "properties": {
                "totalIncomeTax": {
                    "title": "Total Income Tax",
                    "description": "The total calculated Income Tax after allowances and reliefs. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "totalBeforeReliefs": {
                    "title": "Total Before Reliefs",
                    "description": "The total Income Tax before allowances and reliefs. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "totalAfterReliefs": {
                    "title": "Total After Reliefs",
                    "description": "The total Income Tax after allowances and reliefs. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "taxableIncome": {
                    "title": "Taxable Income",
                    "description": "The total income subject to Income Tax calculation. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "payAndPensionsProfit": {
                    "type": "object",
                    "description": "This object gives a breakdown of the income tax calculation in relation to pay, pensions and profit.",
                    "properties": {
                        "totalAmount": {
                            "title": "Total Amount",
                            "description": "The total amount of income tax associated with pay and pensions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "band": {
                            "type": "array",
                            "description": "The banding array shows the tax bands applicable to an Income Tax category. Only bands applicable to the calculation will be generated. (e.g. a BRT taxpayer will not have bands for HRT and ART). There will always be a minimum of 1 band if the array exists. The array will be populated in ascending order of the tax bands.",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "title": "Name",
                                        "description": "The name of the tax band. Must be one of: SRT, BRT, IRT, HRT, ART",
                                        "type": "string",
                                        "oneOf": [
                                            {
                                                "enum": [
                                                    "SRT"
                                                ],
                                                "description": "Scottish starter rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "BRT"
                                                ],
                                                "description": "basic rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "IRT"
                                                ],
                                                "description": "intermediary rate threshold (Scottish only)"
                                            },
                                            {
                                                "enum": [
                                                    "HRT"
                                                ],
                                                "description": "higher rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "ART"
                                                ],
                                                "description": "additional rate threshold"
                                            }
                                        ]
                                    },
                                    "rate": {
                                        "title": "Rate",
                                        "description": "The rate associated with the tax band. The value must be between 0 and 99.99 up to 2 decimal places",
                                        "type": "number",
                                        "example": "10.25",
                                        "minimum": 0,
                                        "maximum": 99.99
                                    },
                                    "threshold": {
                                        "title": "Threshold",
                                        "description": "The upper threshold for the tax band. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "apportionedThreshold": {
                                        "title": "Apportioned Threshold",
                                        "description": "The amount of the upper threshold that has been apportioned. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "income": {
                                        "title": "Income",
                                        "description": "The amount of taxable income for the tax band. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "amount": {
                                        "title": "Amount",
                                        "description": "The calculated amount of Income Tax for the tax band. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "apportionedBandLimit": {
                                        "title": "Apportioned Band Limit",
                                        "description": "The apportioned threshold for the tax band, excluding personal allowance. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "bandLimit": {
                                        "title": "Band Limit",
                                        "description": "The upper threshold for the tax band excluding personal allowance. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    }
                                }
                            }
                        },
                        "personalAllowanceUsed": {
                            "title": "Personal Allowance Used",
                            "description": "The amount of the apportioned annual personal allowance that has been offset against pay and pensions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "taxableIncome": {
                            "title": "Taxable Income",
                            "description": "The taxable income associated with pay and pensions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        }
                    }
                },
                "savingsAndGains": {
                    "type": "object",
                    "description": "This object gives a breakdown of the income tax calculation in relation to savings and gains.",
                    "properties": {
                        "totalAmount": {
                            "title": "Total Amount",
                            "description": "The total amount of Income Tax associated with savings and gains. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "band": {
                            "type": "array",
                            "description": "The banding array shows the tax banding applicable to an Income Tax category. Only bands applicable to the calculation will be generated. (e.g a BRT taxpayer will not have bands for HRT and ART). There will always be a minimum of 1 band if the array exists. The array will be populated in ascending order of the tax bands.",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "title": "Name",
                                        "description": "The name of the tax band. Must be one of the following: SSR,BRT,HRT,ART, ZRTBR, ZRTHR",
                                        "type": "string",
                                        "oneOf": [
                                            {
                                                "enum": [
                                                    "SSR"
                                                ],
                                                "description": "savings starter rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "BRT"
                                                ],
                                                "description": "basic rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "HRT"
                                                ],
                                                "description": "higher rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "ART"
                                                ],
                                                "description": "additional rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "ZRTBR"
                                                ],
                                                "description": "personal savings allowance awarded at basic rate"
                                            },
                                            {
                                                "enum": [
                                                    "ZRTHR"
                                                ],
                                                "description": "personal savings allowance awarded at higher rate"
                                            }
                                        ]
                                    },
                                    "rate": {
                                        "title": "Rate",
                                        "description": "The rate associated with the tax band. The value must be between 0 and 99.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "10.25",
                                        "minimum": 0,
                                        "maximum": 99.99
                                    },
                                    "threshold": {
                                        "title": "Threshold",
                                        "description": "The upper threshold for the tax band. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "apportionedThreshold": {
                                        "title": "Apportioned Threshold",
                                        "description": "The amount of the upper threshold that has been apportioned. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "income": {
                                        "title": "Income",
                                        "description": "The amount of taxable income for the tax band. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "amount": {
                                        "title": "Amount",
                                        "description": "The calculated amount of Income Tax for the tax band. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "apportionedBandLimit": {
                                        "title": "Apportioned Band Limit",
                                        "description": "The apportioned threshold for the tax band, excluding personal allowance. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "bandLimit": {
                                        "title": "Band Limit",
                                        "description": "The upper threshold for the tax band excluding personal allowance. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    }
                                }
                            }
                        },
                        "personalAllowanceUsed": {
                            "title": "Personal Allowance Used",
                            "description": "The amount of the apportioned annual personal allowance that has been offset against savings and gains. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "taxableIncome": {
                            "title": "Taxable Income",
                            "description": "The taxable income associated with savings and gains. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        }
                    }
                },
                "dividends": {
                    "type": "object",
                    "description": "This object gives a breakdown of the income tax calculation in relation to dividends",
                    "properties": {
                        "totalAmount": {
                            "title": "Total Amount",
                            "description": "The total amount of Income Tax associated with dividends. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "band": {
                            "type": "array",
                            "description": "The banding array shows the tax banding applicable to an Income Tax category. Only bands applicable to the calculation will be generated (for example a BRT taxpayer will not have bands for HRT and ART). There will always be a minimum of 1 band if the array exists. The array will be populated in ascending order of the tax bands.",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "title": "Name",
                                        "description": "The name of the tax band. Must be one of the following: BRT, HRT, ART, ZRTBR, ZRTHR, ZRTAR",
                                        "type": "string",
                                        "oneOf": [
                                            {
                                                "enum": [
                                                    "BRT"
                                                ],
                                                "description": "basic rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "HRT"
                                                ],
                                                "description": "higher rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "ART"
                                                ],
                                                "description": "additional rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "ZRTBR"
                                                ],
                                                "description": "dividend allowance awarded at basic rate"
                                            },
                                            {
                                                "enum": [
                                                    "ZRTHR"
                                                ],
                                                "description": "dividend allowance awarded at higher rate"
                                            },
                                            {
                                                "enum": [
                                                    "ZRTAR"
                                                ],
                                                "description": "dividend allowance awarded at additional rate"
                                            }
                                        ]
                                    },
                                    "rate": {
                                        "title": "Rate",
                                        "description": "The rate associated with the tax band. The value must be between 0 and 99.99.",
                                        "type": "number",
                                        "example": "10.25",
                                        "minimum": 0,
                                        "maximum": 99.99
                                    },
                                    "threshold": {
                                        "title": "Threshold",
                                        "description": "The upper threshold for the tax band. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "apportionedThreshold": {
                                        "title": "Apportioned Threshold",
                                        "description": "The amount of the upper threshold that has been apportioned. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "income": {
                                        "title": "Income",
                                        "description": "The amount of taxable income for the tax band. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "amount": {
                                        "title": "Amount",
                                        "description": "The calculated amount of Income Tax for the tax band. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "apportionedBandLimit": {
                                        "title": "Apportioned Band Limit",
                                        "description": "The apportioned threshold for the tax band, excluding personal allowance. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "bandLimit": {
                                        "title": "Band Limit",
                                        "description": "The upper threshold for the tax band excluding personal allowance. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    }
                                }
                            }
                        },
                        "personalAllowanceUsed": {
                            "title": "Personal Allowance Used",
                            "description": "The amount of the apportioned annual personal allowance that has been offset against dividends. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "taxableIncome": {
                            "title": "Taxable Income",
                            "description": "The taxable income associated with dividends. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        }
                    }
                },
                "allowancesAndReliefs": {
                    "type": "object",
                    "description": "This object details the allowances and reliefs used in the income tax calculation",
                    "properties": {
                        "propertyFinanceRelief": {
                            "title": "Property Finance Relief",
                            "description": "The relief against property finance costs. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "totalAllowancesAndReliefs": {
                            "title": "Total Allowances And Reliefs",
                            "description": "The total amount of allowances and reliefs. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        }
                    }
                },
                "giftAid": {
                    "type": "object",
                    "description": "This object shows the amount of Income tax associated to the amount of Gift Aid being declared. The actual Gift Aid benefit itself is reflected as a rate band extension (see annualAllowances.giftAidExtender).",
                    "properties": {
                        "paymentsMade": {
                            "title": "Payments Made",
                            "description": "The total amount of Gift Aid payments made for the tax year. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "rate": {
                            "title": "Rate",
                            "description": "The basic rate of tax that applies to Gift Aid. The value must be between 0 and 99.99.",
                            "type": "number",
                            "example": "10.25",
                            "minimum": 0,
                            "maximum": 99.99
                        },
                        "taxableAmount": {
                            "title": "Taxable Amount",
                            "description": "The taxable amount of the Gift Aid payments made. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        }
                    }
                },
                "totalAfterGiftAid": {
                    "title": "Total After Gift Aid",
                    "description": "The total Income Tax after Gift Aid. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "residentialFinanceCosts": {
                    "type": "object",
                    "description": "This object gives a breakdown of the income tax calculation in relation to residential finance costs",
                    "properties": {
                        "amountClaimed": {
                            "title": "Amount Claimed",
                            "type": "number",
                            "description": "The amount being claimed including any carry forward amounts",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "allowableAmount": {
                            "title": "Allowable Amount",
                            "type": "number",
                            "description": "The lower of: finance costs not deducted, property business profits, adjusted total income (exceeding Personal Allowance)",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "rate": {
                            "title": "Rate",
                            "type": "number",
                            "description": "The tax rate used for the calculation. The value must be between 0 and 99.99 up to 2 decimal places.",
                            "example": "10.25",
                            "minimum": 0,
                            "maximum": 99.99
                        }
                    }
                }
            }
        },
        "nic": {
            "type": "object",
            "description": "This object defines the National Insurance Contributions involved in the calculation. This object will not be present if a business validation failure occurred processing the tax calculation.",
            "properties": {
                "totalNic": {
                    "title": "Total NIC",
                    "description": "The calculated amount of National Insurance contributions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "class2": {
                    "type": "object",
                    "description": "This object defines the Class 2 NIC elements of the calculation",
                    "properties": {
                        "amount": {
                            "title": "Amount",
                            "description": "The calculated amount of Class 2 National Insurance contributions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "weekRate": {
                            "title": "Week Rate",
                            "description": "The weekly rate for Class 2 National Insurance contributions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "weeks": {
                            "title": "Weeks",
                            "description": "The number of weeks applied to calculate Class 2 National Insurance contributions. The value is a whole number in the range 0 to 52.",
                            "type": "number",
                            "example": "1"
                        },
                        "limit": {
                            "title": "Limit",
                            "description": "The annual limit of Class 2 National Insurance contributions. The value must be between 0 and 99999999999.",
                            "type": "number",
                            "example": "1025",
                            "minimum": 0,
                            "maximum": 99999999999
                        },
                        "apportionedLimit": {
                            "title": "Apportioned Limit",
                            "description": "The apportioned amount of annual Class 2 National Insurance contributions. The value must be between 0 and 99999999999.",
                            "type": "number",
                            "example": "1025",
                            "minimum": 0,
                            "maximum": 99999999999
                        }
                    }
                },
                "class4": {
                    "type": "object",
                    "description": "This object defines the Class 4 NIC elements of the calculation",
                    "properties": {
                        "totalAmount": {
                            "title": "Total Amount",
                            "description": "The calculated amount of Class 4 National Insurance contributions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "band": {
                            "type": "array",
                            "description": "The banding array shows the banding applicable to NIC Class 4. Only bands applicable to the calculation will be generated. There will always be a minimum of 1 band if the array exists.",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "title": "Name",
                                        "description": "The name of the tax band. Must be one of: BRT, HRT, ZRT",
                                        "type": "string",
                                        "oneOf": [
                                            {
                                                "enum": [
                                                    "ZRT"
                                                ],
                                                "description": "zero rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "BRT"
                                                ],
                                                "description": "basic rate threshold"
                                            },
                                            {
                                                "enum": [
                                                    "HRT"
                                                ],
                                                "description": "higher rate threshold"
                                            }
                                        ]
                                    },
                                    "rate": {
                                        "title": "Rate",
                                        "description": "The rate associated with the tax band. The value must be between 0 and 99.99.",
                                        "type": "number",
                                        "example": "10.25",
                                        "minimum": 0,
                                        "maximum": 99.99
                                    },
                                    "threshold": {
                                        "title": "Threshold",
                                        "description": "The upper threshold for the tax band. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "apportionedThreshold": {
                                        "title": "Apportioned Threshold",
                                        "description": "The amount of the upper threshold that has been apportioned. The value must be between 0 and 99999999999.",
                                        "type": "number",
                                        "example": "1025",
                                        "minimum": 0,
                                        "maximum": 99999999999
                                    },
                                    "income": {
                                        "title": "Income",
                                        "description": "The amount of taxable income for the tax band. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    },
                                    "amount": {
                                        "title": "Amount",
                                        "description": "The calculated amount of Income Tax for the tax band. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                        "type": "number",
                                        "example": "1000.25",
                                        "minimum": 0,
                                        "maximum": 99999999999.99
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "totalBeforeTaxDeducted": {
            "title": "Total Before Tax Deducted",
            "description": "The subtotal of Income Tax and National Insurance before tax is deducted. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
            "type": "number",
            "example": "1000.25",
            "minimum": 0,
            "maximum": 99999999999.99
        },
        "taxDeducted": {
            "type": "object",
            "description": "This object details the tax deductions that apply to the calculation. This object will not be present if a business validation failure occurred processing the tax calculation.",
            "properties": {
                "totalTaxDeducted": {
                    "title": "Total Tax Deducted",
                    "description": "The total amount of Income Tax and National Insurance that has been deducted. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "savings": {
                    "title": "Savings",
                    "description": "Tax deducted from interest received from UK banks and building societies. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "ukLandAndProperty": {
                    "title": "UK Land And Property",
                    "description": "Tax that has been deducted for UK land and property. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                }
            }
        },
        "eoyEstimate": {
            "type": "object",
            "description": "This object details the End of Year estimate for Income Tax. It will only be populated for in-year calculations; it will not be populated as part of a crystallisation calculation. This object will not be present if a business validation failure occurred processing the tax calculation.",
            "properties": {
                "employments": {
                    "type": "array",
                    "description": "An array of annualised estimated income for each employment",
                    "items": {
                        "type": "object",
                        "properties": {
                            "employmentId": {
                                "title": "Employment ID",
                                "description": "The identifier of the employment.",
                                "type": "string",
                                "example": "XKIS00000000988",
                                "pattern": "^[A-Za-z0-9]{15}$"
                            },
                            "taxableIncome": {
                                "title": "Taxable Income",
                                "description": "The estimated taxable income from this employment. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                "type": "number",
                                "example": "1000.25",
                                "minimum": 0,
                                "maximum": 99999999999.99
                            },
                            "supplied": {
                                "title": "Supplied",
                                "description": "Shows whether the employment income has been supplied or calculated. If true, the employment income has been supplied. If false, the employment income has been calculated.",
                                "type": "boolean",
                                "example": "false"
                            },
                            "finalised": {
                                "title": "Finalised",
                                "description": "Shows whether the employment income has been finalised.",
                                "type": "boolean",
                                "example": "false"
                            }
                        }
                    }
                },
                "selfEmployments": {
                    "type": "array",
                    "description": "An array of annualised estimated income for each self employment business",
                    "items": {
                        "type": "object",
                        "properties": {
                            "selfEmploymentId": {
                                "title": "Self-Employment ID",
                                "description": "An identifier for the self-employment business, unique to the customer.",
                                "type": "string",
                                "example": "XKIS00000000988",
                                "pattern": "^[A-Za-z0-9]{15}$"
                            },
                            "taxableIncome": {
                                "title": "Taxable Income",
                                "description": "The estimated taxable income from this self-employment. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                "type": "number",
                                "example": "1000.25",
                                "minimum": 0,
                                "maximum": 99999999999.99
                            },
                            "supplied": {
                                "title": "Supplied",
                                "description": "Shows whether this self-employment income has been supplied or calculated. If true, the self-employment income has been supplied. If false, the self-employment income has been calculated.",
                                "type": "boolean",
                                "example": "false"
                            },
                            "finalised": {
                                "title": "Finalised",
                                "description": "Shows whether this self-employment income has been finalised.",
                                "type": "boolean",
                                "example": "false"
                            }
                        }
                    }
                },
                "ukProperty": {
                    "type": "object",
                    "description": "An object of annualised estimated income for a UK property business",
                    "properties": {
                        "taxableIncome": {
                            "title": "Taxable Income",
                            "description": "The estimated taxable income from UK property. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "supplied": {
                            "title": "Supplied",
                            "description": "Shows whether the UK property income has been supplied or calculated. If true, UK property income has been supplied. If false, the UK property income has been calculated.",
                            "type": "boolean",
                            "example": "false"
                        },
                        "finalised": {
                            "title": "Finalised",
                            "description": "Shows whether the UK property income has been finalised.",
                            "type": "boolean",
                            "example": "false"
                        }
                    }
                },
                "ukDividends": {
                    "type": "object",
                    "description": "An object of annualised estimated income for UK dividends",
                    "properties": {
                        "taxableIncome": {
                            "title": "Taxable Income",
                            "description": "The estimated taxable income from UK dividends. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                            "type": "number",
                            "example": "1000.25",
                            "minimum": 0,
                            "maximum": 99999999999.99
                        },
                        "supplied": {
                            "title": "Supplied",
                            "description": "Shows whether the UK dividend income has been supplied or calculated. If true, UK dividend income has been supplied. If false, the UK dividend income has been calculated.",
                            "type": "boolean",
                            "example": "false"
                        },
                        "finalised": {
                            "title": "Finalised",
                            "description": "Shows whether the UK dividend income has been finalised.",
                            "type": "boolean",
                            "example": "false"
                        }
                    }
                },
                "savings": {
                    "type": "array",
                    "description": "An array of annualised estimated income  from UK banks, building societies and securities",
                    "items": {
                        "type": "object",
                        "properties": {
                            "savingsAccountId": {
                                "title": "Savings Account ID",
                                "type": "string",
                                "description": "The unique identifier of the savings account",
                                "example": "SAVKB2UVwUTBQGJ"
                            },
                            "taxableIncome": {
                                "title": "Taxable Income",
                                "type": "number",
                                "description": "The estimated annual income from UK banks, building societies and securities. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                                "minimum": 0,
                                "maximum": 99999999999.99
                            },
                            "supplied": {
                                "title": "Supplied",
                                "type": "boolean",
                                "description": "Shows whether the interest from UK banks, building societies and securities has been supplied or calculated.  If true, the amount has been supplied. If false, the amount has been calculated",
                                "example": "false"
                            }
                        }
                    }
                },
                "totalTaxableIncome": {
                    "title": "Total Taxable Income",
                    "description": "The total estimated taxable income from all income. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "incomeTaxAmount": {
                    "title": "Income Tax Amount",
                    "description": "The estimated amount of Income Tax. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "nic2": {
                    "title": "NIC 2",
                    "description": "The estimated amount of Class 2 National Insurance contributions, net of deductions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "nic4": {
                    "title": "NIC 4",
                    "description": "The estimated amount of Class 4 National Insurance contributions, net of deductions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "totalNicAmount": {
                    "title": "Total NIC Amount",
                    "description": "The total estimated amount of National Insurance contributions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                },
                "incomeTaxNicAmount": {
                    "title": "Income Tax And NIC Amount",
                    "description": "The total estimated amount of Income Tax and National Insurance contributions. The value must be between 0 and 99999999999.99 up to 2 decimal places.",
                    "type": "number",
                    "example": "1000.25",
                    "minimum": 0,
                    "maximum": 99999999999.99
                }
            }
        },
        "calculationMessageCount": {
            "title": "Calculation Message Count",
            "description": "The quantity of warning/information messages for the calculation.",
            "type": "number",
            "example": "1"
        },
        "calculationMessages": {
            "type": "array",
            "description": "An array of messages to provide additional context to the calculation",
            "items": {
                "type": "object",
                "properties": {
                    "type": {
                        "title": "Type",
                        "description": "The message type. Must be one of: warning information",
                        "type": "string",
                        "example": "warning"
                    },
                    "text": {
                        "title": "Text",
                        "description": "The message description.",
                        "type": "string"
                    }
                }
            }
        },
        "annualAllowances": {
            "type": "object",
            "description": "This object defines the annual allowances used in the calculation. This object will not be present if a business validation failure occurred processing the tax calculation.",
            "properties": {
                "personalAllowance": {
                    "title": "Personal Allowance",
                    "description": "The annual amount of personal allowance available for the tax year. The value must be between 0 and 99999999999.",
                    "type": "number",
                    "example": "1025",
                    "minimum": 0,
                    "maximum": 99999999999
                },
                "personalAllowanceThreshold": {
                    "title": "Personal Allowance Threshold",
                    "description": "The threshold at which the annual personal allowance is reduced. The value must be between 0 and 99999999999.",
                    "type": "number",
                    "example": "1025",
                    "minimum": 0,
                    "maximum": 99999999999
                },
                "reducedPersonalAllowance": {
                    "title": "Reduced Personal Allowance",
                    "description": "The annual amount that the personal allowance is reduced to, if the income exceeds the personalAllowanceThreshold amount. The value must be between 0 and 99999999999.",
                    "type": "number",
                    "example": "1025",
                    "minimum": 0,
                    "maximum": 99999999999
                },
                "giftAidExtender": {
                    "title": "Gift Aid Extender",
                    "description": "The amount by which the rate band thresholds are extended as a result of Gift Aid claimed against this tax year. The value must be between 0 and 99999999999.",
                    "type": "number",
                    "example": "1000",
                    "minimum": 0,
                    "maximum": 99999999999
                }
            }
        }
    }
}