Calculate UK dividend tax liability
POST
https://app.speybooks.com/api/v1/dividends/tax-calculatorEstimates the dividend tax a shareholder would bear on a gross dividend, given their other taxable income and the personal allowance already used against it. The other income determines which tax bands the dividend falls into: the dividend allowance is applied first, and the remainder is split across the basic, higher, and additional bands. All arithmetic uses decimal rounding to the nearer penny at each band. The result is an advisory estimate, not a binding tax record, and creates no journals. The rate and band figures applied are returned in the response.
Body parameters
grossDividendPenceintegeroptionalGross dividend amount in pence.
otherIncomePenceintegeroptionalOther taxable income in pence (salary, rental, etc.). Default 0.
personalAllowanceUsedPenceintegeroptionalPersonal allowance already used in pence. Default 1257000 (£12,570).
Response
200Tax calculation result with breakdown by band, effective rate, and net dividend.
Show response fields
calculationobjectShow child attributes
dividendAllowancePenceintegereffectiveRateintegernetDividendPenceintegertaxableAfterAllowancePenceintegertotalTaxPenceintegerinputobjectShow child attributes
grossDividendPenceintegerotherIncomePenceintegerpersonalAllowancePenceintegerError codes
400Validation error in calculation inputs.