Client - MTD Savings

A client's savings income for a tax year under MTD Income Tax: the interest reported against each named UK savings account, and the other savings income that belongs to no account (securities interest, foreign interest). Accounts are registered once and live across every tax year while their interest belongs to a single year; HMRC offer no way to delete an account, only to rename it.

OpenAPI Spec

Guides Operations Schemas

POST Add Savings Account
Registers a UK savings account with HMRC and returns the identifier they issue. Accounts are registered once rather than per tax year, and the name mu...
/tenants/{tenant}/clients/{client}/mtd/savings/accounts
PUT Rename Savings Account
Renames a savings account at HMRC. The account keeps its identifier and every year's interest reported against it — this is not a way to replace an ac...
/tenants/{tenant}/clients/{client}/mtd/savings/accounts/{savingsAccountId}/name
PUT Save Savings Account Interest
Sends one savings account's interest for the tax year to HMRC — a full replacement of the taxed/untaxed pair. Omitting one of the two clears it, so se...
/tenants/{tenant}/clients/{client}/mtd/savings/accounts/{savingsAccountId}/{taxYear}
PUT Save Other Savings Income
Sends the year's securities and foreign interest to HMRC. This is a full replacement of what HMRC hold — anything omitted is cleared — so the request ...
/tenants/{tenant}/clients/{client}/mtd/savings/other/{taxYear}
DELETE Delete Other Savings Income
Clears the securities and foreign interest HMRC hold for the tax year. Named accounts are untouched. Who deleted it is recorded.
/tenants/{tenant}/clients/{client}/mtd/savings/other/{taxYear}