API Docs / Schemas / MtdSavingsAccountsDto

MtdSavingsAccountsDto

The client's UK savings accounts and the interest reported against each for one tax year.

The two halves have different lifetimes at HMRC and it matters: an account is registered once
and lives across every year, while its interest belongs to a single year. So an account that
appears here with no interest is a normal, fully-registered account that simply has nothing
reported for the year selected — not a broken or half-created record.

Properties

Name Type Description
clientCodestring

The Sodium client the accounts belong to, stamped by the API on the way out.

The Sodium client the accounts belong to, stamped by the API on the way out.

taxYearstring

The tax year the interest figures below belong to, in HMRC's format, e.g. 2025-26.

The tax year the interest figures below belong to, in HMRC's format, e.g. 2025-26.

accountsarray of MtdSavingsAccountDto

Every account HMRC hold for the client, whichever software registered it. Empty when the
client has none — the normal state, not an error.

Every account HMRC hold for the client, whichever software registered it. Empty when the
client has none — the normal state, not an error.

JSON Example

{
  "clientCode": "string",
  "taxYear": "string",
  "accounts": [
    {
      "savingsAccountId": "...",
      "accountName": "...",
      "isHeld": "...",
      "interest": "...",
      "lastAction": "..."
    }
  ]
}

Contained in Schemas