MtdTaxCalculationDto
HMRC's tax calculation for a client's year, run after a quarterly update was accepted — the
estimated position with the new figures in. HMRC calculates asynchronously, so an incomplete
result shortly after submission is normal: check again rather than treating it as a failure.
Properties
| Name | Type | Description |
|---|---|---|
| calculationId | string | HMRC's identifier for the calculation. |
HMRC's identifier for the calculation. | ||
| taxYear | string | The tax year the calculation covers, e.g. 2025-26. |
The tax year the calculation covers, e.g. 2025-26. | ||
| calculationTimestamp | string | When HMRC finished calculating. Absent while the calculation is still running. |
When HMRC finished calculating. Absent while the calculation is still running. | ||
| periodTo | string | The latest date the calculation covers — how far HMRC's information about the client's income |
The latest date the calculation covers — how far HMRC's information about the client's income | ||
| isComplete | boolean | True once HMRC has finished and produced totals. |
True once HMRC has finished and produced totals. | ||
| hasErrors | boolean | True when the calculation ran but could not produce a usable result. A failed calculation is |
True when the calculation ran but could not produce a usable result. A failed calculation is | ||
| estimatedIncomeTaxNicAmount | number | HMRC's estimated income tax and NICs for the full year — the headline "HMRC now estimates" |
HMRC's estimated income tax and NICs for the full year — the headline "HMRC now estimates" | ||
| estimatedTotalIncome | number | HMRC's estimated total income for the full year. |
HMRC's estimated total income for the full year. | ||
| estimatedTaxableIncome | number | HMRC's estimated taxable income for the full year. |
HMRC's estimated taxable income for the full year. | ||
| totalIncomeTaxAndNicsDue | number | Total income tax and NICs due on the position calculated so far. |
Total income tax and NICs due on the position calculated so far. | ||
| errorMessages | array of string | Why the calculation failed, when it did. |
Why the calculation failed, when it did. | ||
JSON Example
{
"calculationId": "string",
"taxYear": "string",
"calculationTimestamp": "2024-01-01T00:00:00Z",
"periodTo": "2024-01-01",
"isComplete": false
}